OpenAPI (Swagger) beschrijft REST API's: schema's, paden en authenticatie voor documenten en codegen.
OpenAPI 3.x YAML/JSON-specificaties sturen Swagger UI, client-SDK's en contracttests aan. Componenten hergebruiken schema's; servers vermelden basis-URL's per omgeving.
Zorg ervoor dat de specificaties synchroon blijven met de implementatie: consumenten worden afgeleid. Tentaco OpenAPI Validator en Mock Generator lintspecificaties en JSON-voorbeelden lokaal.