Le format de fichier Swagger, désormais officiellement connu sous le nom de spécification OpenAPI (OAS), est un langage de description d'interface lisible par machine permettant de décrire, produire, consommer et visualiser des services web RESTful. Créé à l'origine par SmartBear Software, il permet aux développeurs de définir l'intégralité de la structure d'une API, y compris les points de terminaison disponibles, les paramètres d'opération, les méthodes d'authentification et les schémas de réponse. En utilisant un format standardisé, les fichiers Swagger permettent la génération automatisée de documentation, la création de bibliothèques clientes dans divers langages de programmation et les tests automatisés. Le format est généralement écrit en JSON ou en YAML, ce qui le rend à la fois lisible par l'homme et facile à analyser par les machines. Il sert de plan directeur pour l'API, garantissant que les équipes frontend et backend partagent une compréhension claire du comportement attendu du service. Cela réduit les erreurs d'intégration et accélère le cycle de développement en offrant une approche « contrat d'abord » (contract-first) pour la conception d'API. Il est largement adopté dans l'industrie logicielle comme norme pour la documentation et la conception d'API RESTful, soutenu par un vaste écosystème d'outils pour les tests, le mocking et le déploiement.