Documentação da API de envio

Uma API para enviar e-mails de cadastro, redefinição de senha e notificações do seu site — sem SMTP.

Obtenha uma API key

Disponível agora Propriedade, MX, SPF, DKIM e DMARC são verificados separadamente. Prontos, envie com uma API key e acompanhe no painel os resultados por destinatário: entregues, falhos e pendentes.

Início rápido

  1. 1

    Vincule um domínio

    Adicione seu domínio de envio em Envio para sites.

  2. 2

    Verifique o DNS

    Adicione os registros SPF / DKIM / DMARC e o TXT de verificação, e verifique com um clique.

  3. 3

    Crie uma chave

    Crie uma chave te_live_ — o texto aparece só uma vez, salve na hora.

Enviar um e-mail

Uma requisição POST com sua chave te_live_ no header Authorization.

curl -X POST https://tutuemail.com/api/sending/send \
  -H "Authorization: Bearer te_live_xxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: signup-user-123" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "noreply@your-domain.com",
    "to": "user@example.com",
    "subject": "欢迎注册",
    "html": "<p>点击验证你的邮箱</p>"
  }'

Campos da requisição

from Endereço do remetente, deve estar em um domínio verificado
to Endereço do destinatário (único ou array)
subject Assunto do e-mail
html / text Corpo do e-mail (HTML ou texto simples)
Idempotency-Key Header opcional; reutilize o valor nas retentativas para evitar envios duplicados

Uma requisição aceita retorna HTTP 202 com um id e estado accepted. Com a mesma API key, GET /api/sending/messages/{id} retorna por destinatário: entregue, falhou, pendente ou desconhecido.

Erros e limites

401 Chave inválida ou revogada — gere outra chave te_live_
403 Domínio do remetente não verificado, ou endereço fora de um domínio verificado
429 Taxa de envio excedida; a resposta traz retry_after — tente depois conforme indicado
503 Motor de e-mail temporariamente indisponível; tente novamente com a mesma Idempotency-Key

O número de destinatários, o tamanho do corpo e a taxa têm limites de proteção. O uso é contado só após a validação, então requisições inválidas não consomem sua cota.

Pronto para integrar?

Obtenha uma API key Ver perguntas frequentes