# API da ANYIA — recursos para desenvolvedores

Referência da API pública da ANYIA, a plataforma de agentes de IA para WhatsApp de Aztronic Tecnologia e Servicos LTDA.

## Autenticação

- Todas as rotas, exceto `GET /health` e a documentação, exigem o header `X-API-Key`.
- A chave é emitida em Configurações da organização → Chaves de API, dentro da plataforma.
- Limite de uso: 60 requisições por minuto por chave de API.
- A chave define a organização; a instância de WhatsApp é escolhida pelo `instanceSlug` na rota.

## Base e referência OpenAPI

- A URL base da API pública é exibida em Configurações da organização → Chaves de API, dentro da plataforma.
- A referência OpenAPI navegável fica em `/docs`, sob essa mesma base.

## Endpoints

- `GET /health`: Verifica a disponibilidade da API. Não exige chave.
- `GET /instances/{instanceSlug}/customers`: Lista clientes de uma instância com paginação.
- `POST /instances/{instanceSlug}/customers`: Cria ou atualiza um cliente por telefone e instância.
- `POST /instances/{instanceSlug}/notifications`: Enfileira uma ou mais notificações de WhatsApp.
- `GET /instances/{instanceSlug}/assistants`: Lista os assistentes disponíveis para uma instância.
- `GET /channels`: Lista os canais de notificação.
- `GET /message-types`: Lista os tipos de mensagem de notificação.

## Erros

- `400`: corpo ou parâmetros inválidos.
- `401`: chave de API ausente, inválida ou revogada.
- `404`: instância ou recurso inexistente.
- `429`: limite de requisições excedido.

## Recursos para agentes

- [llms.txt da ANYIA](https://anyia.ia.br/llms.txt): Índice curado do site para LLMs.
- [llms-full.txt da ANYIA](https://anyia.ia.br/llms-full.txt): Conteúdo público completo.
- [Sitemap da ANYIA](https://anyia.ia.br/sitemap.xml): Páginas indexáveis.

Suporte: anyia@aztronic.com.br