OpenAPI (Swagger) descrive le API REST: schemi, percorsi e autenticazione per documenti e codegen.
Le specifiche OpenAPI 3.x YAML/JSON guidano l'interfaccia utente Swagger, gli SDK client e i test dei contratti. I componenti riutilizzano gli schemi; i server elencano gli URL di base per ambiente.
Mantieni le specifiche sincronizzate con l'implementazione: la deriva distrugge i consumatori. Tentaco OpenAPI Validator e Mock Generator specifiche lint ed esempio JSON localmente.