API de envio de e-mail
Envie pelo seu domínio no servidor, compartilhando a mesma cota, cobrança e limites do envio de e-mail no console. O domínio remetente deve corresponder exatamente a um domínio de envio conectado e ativo.
- Autenticação: a mesma chave de API do usuário utilizada pelas demais APIs abertas da plataforma
- Envio: POST /api/v1/mail/send; a resposta é agrupada por destinatário, e bounced_addrs é a única base para limpar sua lista
- Idempotência: com o cabeçalho Idempotency-Key, envios repetidos com a mesma chave enviam exatamente uma vez — sem entregas ou cobranças duplicadas
- Conversas: informe in_reply_to e a cadeia completa de references para que as respostas entrem na conversa original do destinatário
- Cota e domínios: consulte a cota restante de hoje e os domínios de envio utilizáveis para limitar a velocidade no seu sistema
- Exemplos de código: exemplos mínimos funcionais em cURL / Node.js / Python / Go / PHP, todos com idempotência e tratamento de devoluções permanentes
Perguntas frequentes
HTTP 200 significa que todos os destinatários receberam o e-mail?
Não. Os resultados são agrupados por destinatário: uma mensagem para cinco pessoas pode ter 2 entregas, 1 envio na fila e 2 devoluções permanentes. Não há webhook de devolução; por isso, bounced_addrs é a única base para manter sua lista limpa — pare de enviar para esses endereços imediatamente.
Quando Idempotency-Key é necessário?
Sempre que sua chamada puder repetir automaticamente — novas tentativas por tempo limite, reentrega de filas de tarefas ou novas tentativas do SDK. Sem ele, uma falha de rede pode fazer o destinatário receber dois e-mails e você ser cobrado duas vezes, sem possibilidade de reversão. Use uma chave de negócio, como o ID do pedido.
Páginas relacionadas: Documentação de API Tovanix · API de e-mail SMTP · Alta taxa de entrega · Usar a API de agregação SMTP
Carregando…