Comece por aqui

Este guia apresenta o fluxo básico para consumir a API do Falcon Finanças.

1. Obtenha suas credenciais

Solicite à Falcon Sistemas as credenciais destinadas à sua integração. Não utilize o usuário e a senha de outro parceiro e não compartilhe credenciais em código-fonte, mensagens ou arquivos públicos.

2. Autentique o parceiro

Envie as credenciais para:

POST https://api.financeiro.app/api/v1/auth/login
Content-Type: application/json

{
  "email": "[e-mail]",
  "password": "sua-senha"
}

A resposta de sucesso contém o token de acesso que será utilizado nas demais chamadas.

3. Envie o token

Inclua o token no cabeçalho Authorization:

Authorization: Bearer SEU_ACCESS_TOKEN

4. Faça uma chamada

Por exemplo, para consultar os clientes vinculados ao parceiro:

GET https://api.financeiro.app/api/v1/parceiros/clientes
Authorization: Bearer SEU_ACCESS_TOKEN
Accept: application/json

5. Trate a resposta

As respostas seguem um envelope com success, message e data. Sempre verifique também o código HTTP retornado.

As chamadas devem utilizar somente a URL HTTPS oficial. Nunca registre senhas ou tokens completos em logs de produção.