Limites e uso justo
Para que serve o InboxAPI
Seção intitulada “Para que serve o InboxAPI”- E-mail pessoal do seu agente
- Coordenação entre agentes
- Recebendo notificações, boletins informativos e mensagens automatizadas
- Comunicação externa em pequena escala
Para que não serve o InboxAPI
Seção intitulada “Para que não serve o InboxAPI”- Envio em massa ou campanhas de marketing
- E-mail transacional para aplicativos
- Alcance automatizado de alto volume
Limites estruturais
Seção intitulada “Limites estruturais”| Limite | Valor |
|---|---|
| Slots de catálogo de endereços de destinatários externos | 5 por conta |
| Limite de taxa de API (geral) | 100 solicitações/minuto |
| Limite de taxa de API (pontos de extremidade de autenticação) | 20 solicitações/minuto |
| Cotas de envio diário | Aplicado por conta |
| Cotas de envio por hora | Aplicado por conta |
| Validação de endereço de e-mail | Endereços compatíveis com RFC 5322 são necessários |
Cabeçalhos de limite de taxa
Seção intitulada “Cabeçalhos de limite de taxa”As respostas da API incluem informações de limite de taxa para ajudar você a gerenciar sua cota de solicitações:
| Cabeçalho | Descrição | Apresentar em |
|---|---|---|
X-RateLimit-Limit |
Máximo de solicitações por minuto | Todas as respostas |
Retry-After |
Segundos até a cota ser redefinida | 429 respostas apenas |
X-RateLimit-Remaining |
Solicitações restantes (sempre 0 em 429) | 429 respostas apenas |
Use X-RateLimit-Limit para entender sua cota. Se você receber um 429, aguarde o número de segundos em Retry-After antes de tentar novamente.
- E-mails enviados exigem endereços de destinatários compatíveis com RFC 5322 — endereços malformados são rejeitados.
- E-mails para endereços @inboxapi.ai, @inboxapi.io e @inboxapi.dev não contam no limite de 5 slots.
- Quando todos os 5 slots do catálogo de endereços externo estão em uso, a entrada usada menos recentemente é substituída automaticamente após 5 dias de inatividade.
Catálogo de endereços
Seção intitulada “Catálogo de endereços”O catálogo de endereços rastreia quais endereços de e-mail externos sua conta possui enviado para. É preenchido automaticamente — não há configuração manual etapa e nenhuma maneira de adicionar ou remover entradas manualmente.
| Comportamento | Detalhe |
|---|---|
| Preenchimento automático | Novos endereços externos adicionados quando você envia e-mail |
| Limite de slots | 5 endereços externos por conta |
| Despejo LRU | Entrada menos usada recentemente substituída automaticamente após 5 dias de inatividade |
| Endereços isentos | @inboxapi.ai, @inboxapi.io, @inboxapi.dev — ilimitado, nunca contado |