> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useintegra.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução

> Visão geral da API BFI da Integra

## Base URL

```
https://api.useintegra.com.br
```

## Autenticação

Todos os endpoints requerem autenticação via API Key no header `Authorization`:

```bash theme={null}
Authorization: Bearer ik_live_sua_key_aqui
```

<Card title="Como obter uma API Key" icon="key" href="/authentication">
  Gere sua key no painel da Integra em Settings > API Keys.
</Card>

## Endpoints disponíveis

### Campanhas

| Método | Endpoint                 | Descrição                       |
| ------ | ------------------------ | ------------------------------- |
| `GET`  | `/api/v1/campaigns`      | Listar campanhas da organização |
| `GET`  | `/api/v1/campaigns/{id}` | Detalhes de uma campanha        |
| `POST` | `/api/v1/campaigns`      | Criar nova campanha de ligações |

### Chamadas

| Método | Endpoint             | Descrição                    |
| ------ | -------------------- | ---------------------------- |
| `GET`  | `/api/v1/calls`      | Listar histórico de chamadas |
| `GET`  | `/api/v1/calls/{id}` | Detalhes de uma chamada      |

## Rate Limiting

Limite de **60 requests por minuto** por API Key. Veja [Rate Limiting](/rate-limiting) para mais detalhes.

## Formato de erro

```json theme={null}
{
  "error": "Descrição do erro"
}
```

Veja [Erros](/errors) para a lista completa de códigos.