Versionamento
Como a API muda sem quebrar a sua integração.
A versão do contrato é uma data e sai em toda resposta no cabeçalho FrotaSimples-Versao. A versão atual é 2026-10-20.
O que muda sem aviso de versão
Acréscimos compatíveis entram na versão vigente. A sua integração deve tolerá-los:
- campo novo numa resposta ou num evento;
- operação, escopo, tipo de evento ou código de erro novos;
- valor novo num campo de lista fechada (trate o desconhecido sem quebrar).
O que exige versão nova
- remover ou renomear campo, operação ou código de erro;
- mudar o tipo ou o significado de um campo;
- mudar o formato de
dadosde um evento — o campoversaodo evento aumenta.
Mudança incompatível ganha uma data nova, anunciada no histórico de mudanças.