https://api.westhetics.io/v1. Dentro da v1:
- Pode aparecer sem aviso: campo novo numa resposta, evento novo no catálogo, valor novo num campo de texto livre, rota nova.
- Nunca acontece: remover ou renomear um campo, mudar o tipo de um campo, mudar o significado de um código de erro ou de um status.
status novo (trate como “outro”).
Quando algo precisar mudar de forma incompatível, nasce a v2, e as duas convivem por um período anunciado em mudanças.
O contrato
A referência desta documentação sai do mesmo OpenAPI que a API serve, sem autenticação:openapi-typescript ou openapi-generator) ou para importar no seu cliente HTTP.