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.

# 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: índice da documentação, com um link .md por página.
• https://toreva.com.br/llms-full.txt: toda a documentação em um arquivo só.
• 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.