> 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.md).

# API Falcon

A API do [**Falcon Finanças**](https://falcon.financeiro.app) permite integrar sistemas parceiros aos recursos disponibilizados pela Falcon Sistemas.

{% hint style="info" %}
Esta documentação apresenta somente contratos públicos de integração. Endpoints operacionais e serviços internos da Falcon não fazem parte da referência pública.
{% endhint %}

## Comece sua integração

Todas as requisições utilizam HTTPS e recebem ou retornam dados em JSON.

| Item            | Valor                        |
| --------------- | ---------------------------- |
| URL de produção | `https://api.financeiro.app` |
| Versão atual    | `v1`                         |
| Autenticação    | JWT Bearer                   |
| Formato         | JSON em UTF-8                |

Para realizar a primeira chamada:

1. Leia o guia [Comece por aqui](/api/comece-por-aqui.md).
2. Entenda como funciona a [Autenticação](/api/autenticacao.md).
3. Consulte a [API para Parceiros](/api/parceiros.md).
4. Trate os [formatos de resposta e erros](/api/respostas-e-erros.md).

## Contratos disponíveis

### API para Parceiros

Permite autenticar o parceiro, consultar seus clientes, consultar ou atualizar planos e inativar vínculos.

[Acessar a API para Parceiros](/api/parceiros.md)

## Evolução da API

Os contratos públicos são versionados. Alterações incompatíveis serão publicadas em uma nova versão, preservando a integração existente durante o período de migração.

Consulte [Versionamento e compatibilidade](/api/versionamento.md) antes de iniciar uma integração de longo prazo.