Pular para o conteúdo
Voltar para a home

Começar

Introdução

A API do JetSend é REST e JSON, autenticada por Bearer token. Quem já usa Resend troca a URL base e a chave, e o resto do código continua igual.

URL base

Todas as chamadas saem de https://api.jetsend.com.br, e todos os caminhos começam com /v1. Não existe endpoint fora do /v1, então versão nova não quebra integração antiga.

O primeiro envio

Este comando manda um e-mail de verdade sem gastar reputação e sem precisar de domínio verificado, porque o destinatário é um apelido de teste. Troque só a chave.

shell
curl -X POST https://api.jetsend.com.br/v1/messages \  -H "Authorization: Bearer $JETSEND_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "from": "no-reply@suaempresa.com.br",    "to": "entregue@teste.jetsend.com.br",    "subject": "Primeiro envio",    "html": "<p>Funcionou.</p>"  }'

A resposta traz o id da mensagem. Esse id é o que aparece no painel, no log de envios e nos webhooks.

O que a API faz

RecursoEndpointsOnde está documentado
MensagensPOST /v1/messages, GET /v1/messagesEnviar e-mail
DomíniosPOST, GET, DELETE /v1/domains, POST /v1/domains/:id/verifyVerificar domínio
Chaves de APIPOST, GET, DELETE /v1/api-keysAutenticação
EventosGET /v1/eventsWebhooks e eventos
WebhooksPOST, GET, DELETE /v1/webhooksWebhooks e eventos
SupressõesGET /v1/bloqueios, DELETE /v1/bloqueios/:idWebhooks e eventos

Formato das respostas

Resposta de sucesso vem em JSON com os campos do recurso. Erro vem com o código HTTP correspondente e um corpo JSON explicando o motivo em português. Os que você vai encontrar mais:

  • 401, chave ausente, malformada ou revogada.
  • 403, a chave é válida mas o papel dela não permite a ação. Ver Autenticação.
  • 402, o plano não cobre este envio, por cota estourada ou assinatura sem pagamento.
  • 413, o corpo do e-mail passou do teto de bytes de html ou text.
  • 422, o remetente não pertence a um domínio verificado seu.

Por onde começar

Se você quer código rodando agora, vá para o quickstart da sua linguagem: Node.js, Python, PHP ou cURL. Se você está migrando, Migrar do Resend é o caminho curto. Se o seu sistema não fala REST, existe o gateway SMTP na porta 587.