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

# Introdução

> Aviso de descontinuação e informações básicas da v1 da API de Clientes.

<Warning>
  A **v1** está descontinuada e mantida apenas por compatibilidade com integrações legadas. Apenas o endpoint de **Centro de Custo** continua documentado aqui. Para novas integrações, utilize a **v2** — selecione-a no seletor de versão no topo desta documentação.
</Warning>

## Base URL

A API de Integração Gestio disponibiliza dois ambientes:

| Ambiente | Base URL | Uso |
| - | - | - |
| Produção | `https://api.gestio.com.br` | Dados reais dos seus clientes |
| Desenvolvimento | `https://devapi.gestio.com.br` | Testes e homologação da integração |

O endpoint desta referência está disponível sob o prefixo `/v1`, por exemplo `/v1/centrodecusto`.

## Autenticação

A v1 não possui rota de autenticação própria — utilize a mesma autenticação da v2, `POST /v2/autenticar`, e envie o token no header `Authorization`:

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

## Formato de resposta

Os mesmos formatos de resposta da v2 se aplicam aqui — envelope `{ "success": true, "data": ... }` em caso de sucesso, e `{ "success": false, "errors": [...] }` em caso de erro de validação (HTTP `400`).

<Info>
  Para o detalhamento completo de autenticação, formato de resposta, códigos de status e limites, consulte a Introdução da v2.
</Info>