OPENAPI-EDI

Le standard de spec des APIs REST — utilisé pour exposer les APIs EDI canoniques.

Définition

OpenAPI 3.1.0 (publié 2021) est compatible JSON Schema 2020-12 par construction. Supporte security schemes (OAuth 2.0, OIDC, mTLS), webhooks, server variables, examples. Génération de client SDKs (TypeScript, Python, Go, Java) via openapi-generator. Mock servers via Prism. Adopté par tous les iPaaS modernes.

Origine

Origine Swagger (Tony Tam, 2011). Transféré à la Linux Foundation comme OpenAPI Initiative en 2015.

Exemple en contexte

Un fichier openapi.yaml qui décrit POST /api/v1/orders, schemas Order/OrderLine, security: bearer JWT.

Termes liés

• REST — paradigme décrit par OpenAPI.
• JSON Schema — utilisé par OpenAPI.