Versionamento, compatibilidade e erros
Fixe versões de contratos em automações e trate respostas por código, sem depender da mensagem humana.
Superfícies versionadas
CHAVE
DESCRIÇÃO
API v1/v2Compatibilidade por rota
CATÁLOGOVersão 2
SDKsVersão semântica
DOCUMENTOSVersões imutáveis por portfólio
Envelope de erro
Erros públicos incluem error, code, details, requestId, retryable e docUrl.
Contratos legíveis por máquina
Use OpenAPI 3.1 e llms.txt.