Guia 11/12

Versões e descontinuação

A versão está no caminho: /api/v1.

Alterações compatíveis (a qualquer momento)

• Novos endpoints, campos, parâmetros opcionais, valores de enum e eventos de webhook.
• O seu cliente deve ignorar campos desconhecidos e tolerar valores novos.

Alterações incompatíveis (só numa versão nova)

• Retirar ou renomear campos, mudar tipos ou significados, novos parâmetros obrigatórios — só em /v2, mantendo /v1 em paralelo.

Descontinuação

Os endpoints descontinuados respondem com os cabeçalhos Deprecation e Sunset pelo menos 6 meses antes de serem retirados, e a mudança é anunciada no registo de alterações.

HTTP/1.1 200 OK
Deprecation: @1798761600
Sunset: Wed, 30 Jun 2027 00:00:00 GMT
Link: <https://anagen.pt/desenvolvedores/guias/alteracoes>; rel="deprecation"