cloudflare / doca

A CLI tool that scaffolds API documentation based on JSON HyperSchemas.
BSD 3-Clause "New" or "Revised" License
228 stars 36 forks source link

POST schema with type of array results in no parameters or data in cURL request #29

Closed Relequestual closed 7 years ago

Relequestual commented 7 years ago

The root of my POST schema is an array object type. The resulting parameters for the request are blank in the finished documentation.

schema => {
  type => 'array',
  items => {
    type => 'object',
    properties => make_properties(stuff),
  }
}

vs

schema => {
  type => 'object',
  properties => make_properties(stuff),
}

Sorry I've just realised I've given this in perl hash format rather than json, but you get the idea.

Relequestual commented 7 years ago

In addition, as a thought, how does splitting required and optional work in the instance where you have oneOf? I guess for the sake of the docs, I'll have to include something in the description, but it makes it somewhat complex.

Relequestual commented 7 years ago

Great! Thanks for the merge. Any idea when a new release can be expected with a new release of json-schema-example-loader ? =]