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.
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
| Recurso | Endpoints | Onde está documentado |
|---|---|---|
| Mensagens | POST /v1/messages, GET /v1/messages | Enviar e-mail |
| Domínios | POST, GET, DELETE /v1/domains, POST /v1/domains/:id/verify | Verificar domínio |
| Chaves de API | POST, GET, DELETE /v1/api-keys | Autenticação |
| Eventos | GET /v1/events | Webhooks e eventos |
| Webhooks | POST, GET, DELETE /v1/webhooks | Webhooks e eventos |
| Supressões | GET /v1/bloqueios, DELETE /v1/bloqueios/:id | Webhooks 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 dehtmloutext.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.
