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

# Guia de Integração

> Aprenda como integrar os produtos Toolzz nas suas aplicações

## Como Integrar com as APIs Toolzz

Este guia vai te mostrar, de forma simples, como integrar os produtos Toolzz nas suas aplicações.

## Autenticação

Todas as APIs Toolzz utilizam autenticação via token Bearer. Basta incluir sua chave de API no cabeçalho Authorization:

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

<Info>
  Para obter sua chave de API, entre em contato com nosso suporte: [contato@toolzz.me](mailto:contato@toolzz.me)
</Info>

## Padrões da API

Nossas APIs seguem o padrão REST e utilizam os métodos HTTP mais comuns:

* `GET` - Buscar informações
* `POST` - Criar novos dados
* `PUT` - Atualizar dados existentes
* `DELETE` - Remover dados

### Formato das Respostas

Todas as respostas das APIs são em formato JSON e trazem códigos de status padrão:

```json theme={null}
{
  "success": true,
  "data": {
    // Dados da resposta
  },
  "message": "Operação realizada com sucesso"
}
```

## Limite de Requisições (Rate Limiting)

Para garantir a estabilidade do serviço, nossas APIs possuem limites de requisições:

* Plano Padrão: 100 requisições por minuto
* Plano Consultivo: Limites personalizados

## Boas Práticas

1. **Tratamento de Erros**
   * Sempre trate erros de forma adequada
   * Verifique os códigos de status das respostas
   * Registre informações relevantes sobre erros

2. **Segurança**
   * Nunca exponha suas chaves de API
   * Use variáveis de ambiente
   * Valide todas as requisições recebidas

3. **Performance**
   * Faça cache das respostas quando possível
   * Implemente tentativas automáticas (retry) em caso de falha
   * Use paginação para grandes volumes de dados

## Suporte

Se precisar de ajuda com a integração:

* E-mail: [contato@toolzz.me](mailto:contato@toolzz.me)
* Documentação: Consulte os guias específicos de cada produto
* Status: Acompanhe o status do sistema