> For the complete documentation index, see [llms.txt](https://ajuda.financeiro.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.financeiro.app/api/versionamento.md).

# Versionamento e compatibilidade

Os contratos públicos da API do [**Falcon Finanças**](https://falcon.financeiro.app) são versionados na URL.

Exemplo da versão atual:

```
/api/v1/...
```

## Alterações compatíveis

Podem ser disponibilizadas na mesma versão:

* inclusão de novos endpoints;
* inclusão de campos opcionais;
* novos códigos de erro documentados;
* melhorias nas descrições e exemplos.

Integrações devem ignorar campos JSON desconhecidos para permanecerem compatíveis com futuras inclusões.

## Alterações incompatíveis

Mudanças como remoção de campos, alteração de tipos ou mudança obrigatória no formato da requisição devem ser publicadas em uma nova versão.

Quando isso ocorrer, a Falcon comunicará o período de migração e manterá a versão anterior durante o prazo informado.