API Versioning - Definição do Glossário de CI/CD
O versionamento de API é a prática de rotular uma API para que os clientes continuem funcionando quando ela muda, usando um segmento de URL (/v2/), um header (Accept: application/vnd.github+json) ou uma versão baseada em data.
Por que importa
Fixar uma versão de API em scripts de CI (por exemplo, um header X-GitHub-Api-Version datado do GitHub) impede que um pipeline quebre no dia em que um provedor lança uma mudança incompatível com versões anteriores.
Guias relacionados
OpenAPI Specification - CI/CD Glossary DefinitionOpenAPI Specification: The OpenAPI Specification (formerly Swagger) is a machine-readable, language-agnostic…
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…
JSON Schema - CI/CD Glossary DefinitionJSON Schema: JSON Schema is a vocabulary for validating the structure of JSON: it declares required fields, t…