# Integrar com IA

Copie o bloco abaixo e entregue ao seu assistente de código. O mesmo texto está no botão **Copiar instruções para IA** da tela **API** do app.

```md
# Integração com a API Torêva

Você vai integrar a API Torêva neste projeto.

- Documentação completa em um arquivo: https://toreva.com.br/llms-full.txt
- Contrato OpenAPI: https://api.toreva.com.br/v1/openapi.json
- URL base: https://api.toreva.com.br
- Autenticação: cabeçalho `Authorization: Bearer <chave>`. Leia a chave da variável de ambiente `TOREVA_API_KEY`. Nunca escreva a chave no código nem a use em código que roda no navegador.
- Consulta: `GET /v1/cnpj/{cnpj}`. Aceita CNPJ com ou sem máscara e CNPJ alfanumérico: remova só `.`, `/` e `-`, nunca tudo que não for dígito.
- Trate erros pelo campo `code` da resposta, não pela mensagem. Repita com espera crescente só em 408, 429, 500 e 503.
- A mesma consulta em até 24 horas não é cobrada de novo (cabeçalho `X-Toreva-Charged`).

Leia a documentação antes de escrever o cliente.
```

## Arquivos para agentes

- [`https://toreva.com.br/llms.txt`](https://toreva.com.br/llms.txt): índice da documentação, com um link `.md` por página.
- [`https://toreva.com.br/llms-full.txt`](https://toreva.com.br/llms-full.txt): toda a documentação em um arquivo só.
- [`https://api.toreva.com.br/v1/openapi.json`](https://api.toreva.com.br/v1/openapi.json): o contrato OpenAPI.

Toda página desta documentação também existe em Markdown: acrescente `.md` ao endereço, como em `https://toreva.com.br/developers/consulta-cnpj.md`.

## Como usar

- **Claude:** cole o bloco no começo da conversa ou salve no arquivo `CLAUDE.md` do projeto.
- **Cursor:** salve o bloco como regra do projeto, na pasta `.cursor/rules`.
- **ChatGPT:** cole o bloco no começo da conversa e anexe o `llms-full.txt` se ele não conseguir abrir links.