DISCRIMINATOR-OAS

Keyword OpenAPI pour polymorphisme appliqué aux schémas EDI.

Définition

discriminator est défini dans OpenAPI 3.0+. Annonce un propertyName dont la valeur sélectionne dynamiquement le sous-schéma à appliquer (mapping vers oneOf). Utilisé pour modéliser des familles de messages EDI hétérogènes — discriminator.propertyName='transactionSetId', mapping vers '850': PurchaseOrder, '855': PurchaseOrderAck, '810': Invoice.

Origine

Introduit dans OpenAPI 3.0 (2017), affiné en 3.1 (alignement JSON-Schema 2020-12).

Exemple en contexte

components.schemas.X12Message: {oneOf: [{$ref: '#/components/schemas/PO'}, ...], discriminator: {propertyName: 'transactionSetId', mapping: {'850': '#/components/schemas/PO'}}}

Termes liés

• OpenAPI 3.1 — spécification.
• JSON-Schema 2020-12 — alignement.