Une spécification OpenAPI, c'est un document standardisé qui décrit en détail comment fonctionne une API : ses endpoints, ses paramètres, ses réponses. Lisible par l'humain et la machine, elle sert de contrat et de mode d'emploi. Des outils s'en servent pour générer automatiquement de la documentation, des SDK ou des tests. C'est la carte officielle d'une API.
Exemple — À partir d'une spec OpenAPI, un outil génère automatiquement la documentation interactive d'une API.