> 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/comece-por-aqui.md).

# Comece por aqui

Este guia apresenta o fluxo básico para consumir a API do [**Falcon Finanças**](https://falcon.financeiro.app).

## 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:

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

```json
{
  "email": "integracao@empresa.com.br",
  "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`:

```http
Authorization: Bearer SEU_ACCESS_TOKEN
```

## 4. Faça uma chamada

Por exemplo, para consultar os clientes vinculados ao parceiro:

```http
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.

{% hint style="warning" %}
As chamadas devem utilizar somente a URL HTTPS oficial. Nunca registre senhas ou tokens completos em logs de produção.
{% endhint %}