OPENAPI-3-1-DETAIL

Spec API REST aligne JSON Schema.

Définition

OpenAPI 3.1 introduit le full alignment JSON Schema 2020-12 (versus 3.0 qui était un dialecte subset). Supports webhooks, multiple media types, $ref unbounded, true OAS Common Annotations. Outils écosystème : Swagger UI, ReDoc, Postman import, Spectral linting, openapi-generator CLI (~70 langages). Successeur d'OpenAPI 3.0.x publié 2017.

Origine

OpenAPI 3.1.0 publie 17 fevrier 2021 par OpenAPI Initiative ; OpenAPI 3.0.0 publie 2017 ; Swagger 2.0 publie 2014.

Exemple en contexte

Stripe API documente ses ~5000 endpoints en OpenAPI 3.1 YAML ; SDK auto-generes pour Python, Node.js, Java, Go via openapi-generator.

Termes liés

• AsyncAPI 3 — jumeau event-driven.