Changelog

Por API e contrato

Cada página abaixo é gerada no build a partir do CHANGELOG.md que o serviço mantém no próprio repositório (ramo main). Entra só o que toca o contrato público; o registro completo fica no repositório.

API de conteúdocanverly-api

Sites e organizaçõescanverly-tenancy

Formulárioscanverly-forms

Contratos de eventoscanverly-contracts

A versão atual de cada especificação aparece no topo da respectiva página em OpenAPI por serviço.

Política de versões

• A versão da API está no prefixo da URL (/v1, /v2, …). Mudança incompatível entra como uma versão nova de prefixo; a atual continua no ar.
• Mudança aditiva (campo opcional novo, endpoint novo, valor novo num enum) entra sem aviso prévio e sem trocar o prefixo. Escreva o seu cliente para ignorar campos que não conhece.
• Suporte N-1: quando uma versão nova de prefixo for lançada, a versão imediatamente anterior continua suportada. Hoje só existe a /v1.

O que ainda está a definir

A definir

Estes pontos da política ainda não foram decididos e, por isso, não têm número aqui: por quanto tempo a versão N-1 continua no ar depois do lançamento da N; com que antecedência mínima uma depreciação é anunciada; e por qual canal, além desta página, o aviso chega a quem integra.

A documentação publicada desde o antigo docs.canverly.com promete aviso de pelo menos 90 dias (Referência interativa); esse prazo não está registrado como decisão e fica a confirmar.