If in is any value apart from “body” :
Parameter Object Examples
A human anatomy parameter with a referenced schema meaning (generally for a model definition):
A human anatomy parameter this is certainly a myriad of sequence values:
A header parameter with a range of 64 bit numbers that are integer
A course parameter of the sequence value:
An optional query parameter of the sequence value, permitting numerous values by saying the question parameter:
A questionnaire data with file kind for a file upload:
A restricted subset of JSON-Schema’s products item. It’s utilized by parameter definitions that aren’t positioned in “body” .
Items Object Examples
Things should be of kind string and also have the length that is minimum of figures:
A myriad of arrays, the array that is internal of kind integer, figures should be between 0 and 63 (inclusive):
A container for the expected responses of a procedure. The container maps A http reaction rule to your anticipated reaction. It is really not anticipated through the documents to fundamentally protect all feasible HTTP response codes, simply because they might not be understood ahead of time. Nevertheless, it really is anticipated through the documents to pay for an operation that is successful and any understood mistakes.
The standard can be utilized because the standard reaction item for many HTTP codes being maybe perhaps maybe not covered separately because of the specification.
The reactions Object MUST contain a minumum of one reaction rule, plus it must be the reaction for the effective procedure call.
Reactions Object Example
A 200 reaction for successful procedure and a standard reaction for other individuals (implying a mistake):
Defines a solitary reaction from an API procedure.
Reaction examples that are object
Reaction of a myriad of a complex kind:
Response having a sequence type:
Reaction with headers:
Reaction without any return value:
Listings the headers which can be delivered as an element of a reaction.
Headers Object Example
Allows examples that are sharing procedure reactions.
Example Object Example
Sample reaction for application/json mimetype of a Pet information type:
Header Object Example
A easy header with of a integer type:
Allows meta that is adding to just one label which is used because of the Operation Object. It isn’t mandatory to own a Tag Object per tag utilized here.
Tag Object Example
A easy item to enable referencing other definitions into the specification. It can be utilized to reference parameters and reactions which are defined during the level that is top reuse.
The Reference Object is a JSON guide that runs on the JSON Pointer as its value. Because of this specification, just canonical dereferencing is supported.
Guide Object Example
General Schema File Example
General Data With Embedded Schema Example
The Schema Object permits the meaning of output and input information kinds. These kinds may be things, but additionally primitives and arrays. This item is dependant on the JSON Schema Specification Draft 4 and runs on the subset that is predefined of. Together with this subset, you can find extensions given by this specification to permit for lots more documentation that is complete.
More information concerning the properties are located in JSON Schema Core and JSON Schema Validation. Unless stated otherwise, the house definitions proceed with the JSON Schema specification as referenced right right right here.
The next properties are taken straight through the JSON Schema meaning and stick to the exact same specs:
The properties that are following extracted from the JSON Schema meaning but their definitions had been modified into the Swagger Specification. Their meaning is equivalent to the main one from JSON Schema, just in which the definition that is original the JSON Schema meaning, the Schema Object meaning can be used rather.
Aside from the JSON Schema subset industries, the fields that are following be properly used for further schema documents.
Composition and Inheritance (Polymorphism)
Swagger permits combining and expanding model definitions making use of the allOf home of JSON Schema, in place model composition that is offering. allOf ingests a range of item definitions which can be validated individually but together write an object that is single.
While official statement structure provides model extensibility, it generally does not indicate a hierarchy amongst the models. To aid polymorphism, Swagger adds the help for the discriminator industry. Whenever utilized, the discriminator would be the title associated with property utilized to choose which schema meaning is employed to validate the dwelling regarding the model. As a result, the discriminator industry needs to be a field that is required. The worth regarding the plumped for home needs to end up being the name that is friendly towards the model beneath the definitions home. As a result, inline schema definitions, that do not have confirmed id, can not be utilized in polymorphism.
The xml property allows additional definitions whenever translating the JSON meaning to XML. The XML Object contains information that is additional the available choices.
Schema Object Examples
Unlike earlier incarnations of Swagger, Schema definitions may be used to explain ancient and arrays too.