srch

Sep 27, 2021 · September 27, 2021 · 3 min read. The Discriminator object in OpenAPI v3 supports a set of mapping values that helps determine which schema to map to based on the discriminator property's value in the payload. We have now added support for this set of mapping values in our OpenAPI v3 import and export. Previously, only the key or title of each ...

Sep 25, 2016 · The discriminator functionality has been much improved in OpenApi 3. You now provide a discriminator object which contains the name of the discriminator property, as well as a mapping of values of that property to schema names. (I realize you did ask about OpenApi 2, but this is so much improved in 3 that hopefully you can make use of it).

28.06.2018 · Currently it's not taken in account when generating model (it's not for Java, may be for every other language too) openapi-generator version. 3.1.0-SNAPSHOT

In OpenAPI version 3, you do this with the allOf keyword: ... In our example, the discriminator points to the objectType property that contains the data ...

17.10.2019 · Hi, Firstly, congratulations for your tool. It is really the best viewer that I could have used! From redoc v2.0.0-rc.18, I have a problem with discriminator & mapping fields of OpenAPI 3 Indeed, below, we can see my screenshot from the ...

27.09.2021 · In the example above, the model Dog will have a discriminator value of cachorro as specified in the mapping values of model Pet.Whereas, the model Cat will have a discriminator value of Cat since it has no mapping information available and, therefore, the schema's name is picked up as its discriminator value.. Impact#. If you've been using Discriminator mapping in …

As of today, a Google search of "openapi discriminator example" yields ... that would be great, but discriminator can only map to one field?

One possible example are code generation tools: they can use discriminator to generate program statements that typecast request data to appropriate object type based on the discriminator property value. Mapping Type Names It is implied, that the property to which discriminator refers, contains the name of the target schema.

Oct 17, 2019 · Hi, Firstly, congratulations for your tool. It is really the best viewer that I could have used! From redoc v2.0.0-rc.18, I have a problem with discriminator & mapping fields of OpenAPI 3 Indeed, below, we can see my screenshot from the ...

05.04.2018 · As of today, a Google search of "openapi discriminator example" yields a smattering of partial examples, plus one attempt at an example, last commented on 10 weeks ago which, alas, ends up just showing a frustrated user "struggling" (unsuccessfully) to get that example to work. nkavian commented on Apr 27, 2020

For example, a valid OpenAPI 3.0.2 document, upon changing its openapi property to 3.1.0, ... The name of the property in the payload that will hold the discriminator value. mapping: Map[string, string] An object to hold mappings between payload values and schema names or references.

The Discriminator object in OpenAPI v3 supports a set of mapping values that helps determine which schema to map to based on the ...

08.12.2020 · In the OpenAPI documentation there is example of using discriminator components: responses: sampleObjectResponse: content: application/json: schema: oneOf:...

In this example the powerSource property must be declared in each of the corresponding schemas. The discriminated property must be of type string. The mapping ...

discriminatorMapping() to define an optional mapping definition in scenarios involving ... See Also: Discriminator (OpenAPI specification), Schema ...

Simple example: openapi: 3.0.2 servers: - url: ... $ref: '#/components/schemas/obj2Item' discriminator: propertyName: type mapping: obj1: ...

Apr 05, 2018 · As of today, a Google search of "openapi discriminator example" yields a smattering of partial examples, plus one attempt at an example, last commented on 10 weeks ago which, alas, ends up just showing a frustrated user "struggling" (unsuccessfully) to get that example to work.

Using the OpenAPI discriminator When an API can return two or more different types of objects (aka polymorphism), use oneOf or anyOf to describe those schemas (a JSON Schema concept). You might also want to use the discriminator (an OpenAPI concept).

One possible example are code generation tools: they can use discriminator to generate program statements that typecast request data to appropriate object type based on the discriminator property value. Mapping Type Names It is implied, that the property to which discriminator refers, contains the name of the target schema.

This page shows Java code examples of io.swagger.v3.oas.models.media.Discriminator. ... setMapping(mapping); } return discriminator; }. Example 4 ...

The discriminator is the schema property name that is used to differentiate between other schema that inherit this schema. The property name ...

I just created an example to illustrate what I think is idiomatic use of discrimator, so I could help answer #2141.I find it helpful to use JSON Schema Lint so I can validate in real-time. To make sure the discriminating logic worked correctly in a standard JSON Schema validator (not aware of OAS discriminator), I used standard JSON Schema keywords to duplicate that logic.

For more details, see the OpenAPI Specification. Example. The following is an example of how this issue could look in your API definition. Here, the ...

4.8.25 Discriminator Object ... examples, Map[ string , Example Object | Reference Object], An object to hold reusable Example Objects.

In your SpecB example, every keyword from Pet-- including the definition of petType, the requirement to include the petType property, and the use of petType as the discriminator -- becomes part of Reptile. The discriminator takes effect when a schema that includes the discriminator is directly or indirectly used in a request or response.