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

# Introdução à API

> Autenticação, URL base e como usar a referência gerada a partir do contrato OpenAPI

A Extat Plataforma expõe uma API REST documentada a partir do contrato sincronizado com o ambiente de stage. Esta página descreve autenticação e URL base. As operações aparecem automaticamente no grupo **Operações** desta aba.

## Autenticação

Operações protegidas usam o esquema `ApiKeyAuth` do contrato: envie o token no cabeçalho `Authorization`.

Na aplicação web, o cliente HTTP envia o JWT da sessão no formato `Bearer <token>`.

```http theme={null}
Authorization: Bearer <token>
```

<Warning>
  Não há fluxo documentado na plataforma para gerar um token de API em Minha Conta. Use o token de sessão obtido no login (e-mail/senha ou Google), como a própria aplicação faz.
</Warning>

## URL base

O playground e os exemplos desta documentação usam o host de stage com o `basePath` `/v1`:

```text theme={null}
https://golang-api-vgnqx.ondigitalocean.app/v1
```

Em outros ambientes, use o host da API configurado para aquele ambiente. Um hostname público de produção separado não está publicado nesta documentação.

## Formato

Requisições e respostas usam JSON. Em corpos JSON, inclua `Content-Type: application/json`.

## Operações

Abra o grupo **Operações** nesta aba. As páginas são geradas a partir de `openapi/extat-openapi.json` e agrupadas por domínio em português: Autenticação, Empresa, Contas Bancárias, Demonstrativos, Plano e Assinaturas, entre outros.

## Códigos HTTP comuns

Os códigos exatos por operação estão nas páginas geradas. Em geral:

| Código | Significado                      |
| ------ | -------------------------------- |
| `200`  | Sucesso                          |
| `201`  | Recurso criado                   |
| `400`  | Requisição inválida              |
| `401`  | Autenticação ausente ou inválida |
| `403`  | Sem permissão                    |
| `404`  | Recurso não encontrado           |
| `500`  | Erro no servidor                 |

## Suporte

Dúvidas de produto: <a href="/suporte/troubleshooting">solução de problemas</a> ou e-mail de suporte na barra superior.