OpenAPI Specification - Definição do Glossário de CI/CD
A OpenAPI Specification (antiga Swagger) é uma descrição legível por máquina e independente de linguagem de uma REST API em YAML ou JSON, listando cada path, método, parâmetro e schema de resposta.
No CI
Um pipeline pode fazer lint de um documento OpenAPI, gerar código de cliente a partir dele e rodar contract tests que asseguram que o serviço em execução corresponde à spec, detectando mudanças de API que quebram compatibilidade antes da release.
Guias relacionados
JSON Schema - CI/CD Glossary DefinitionJSON Schema: JSON Schema is a vocabulary for validating the structure of JSON: it declares required fields, t…
API Versioning - CI/CD Glossary DefinitionAPI Versioning: API versioning is the practice of labeling an API so clients keep working when it changes, us…
REST API - CI/CD Glossary DefinitionREST API: A REST API is a web interface that exposes resources at URLs and is operated with standard HTTP met…