OpenAPI (Swagger) describes REST APIs — schemas, paths and auth for docs and codegen.
OpenAPI 3.x YAML/JSON specs drive Swagger UI, client SDKs and contract tests. Components reuse schemas; servers list base URLs per environment.
Keep specs in sync with implementation — drift breaks consumers. Tentaco OpenAPI Validator and Mock Generator lint specs and sample JSON locally.