La spécification OpenAPI (OAS), anciennement connue sous le nom de spécification Swagger, est un standard mondialement reconnu pour définir et documenter les API RESTful. Un fichier .openapi sert de description d'interface indépendante du langage de programmation, permettant aux humains comme aux machines de découvrir et de comprendre les capacités d'un service web sans nécessiter l'accès au code source sous-jacent. Ces fichiers sont généralement structurés en format YAML ou JSON et contiennent des informations détaillées sur les points de terminaison (endpoints) de l'API, notamment les opérations disponibles, les paramètres d'entrée, les formats de sortie, les exigences d'authentification et les informations de licence. En utilisant ce format, les développeurs peuvent mettre en œuvre une méthodologie de conception « API-first », garantissant que l'interface est clairement définie avant l'écriture du moindre code. Cela facilite grandement la génération automatisée de documentation interactive, de kits de développement logiciel (SDK) côté client, de squelettes de serveurs (server stubs) et de suites de tests complètes. Le format est maintenu par l'OpenAPI Initiative, un consortium sous l'égide de la Linux Foundation, et est devenu le standard de l'industrie pour le développement web moderne, permettant une intégration transparente entre des systèmes disparates et améliorant la collaboration entre les équipes d'ingénierie frontend et backend.