Começar
Quickstart Python
Use requests (síncrono) ou httpx (suporta async). Funciona com Python 3.8+.
1. Instalação
shell
pip install requests2. Enviar o primeiro e-mail
python
import osimport requestsKEY = os.environ["JETSEND_KEY"] # sm_live_...r = requests.post( "https://api.jetsend.com.br/v1/messages", headers={"Authorization": f"Bearer {KEY}"}, json={ "from": "no-reply@suaempresa.com.br", "fromName": "Sua Empresa", "to": "cliente@exemplo.com", "subject": "Bem-vindo!", "html": "<h1>Olá!</h1><p>Sua conta foi criada.</p>", }, timeout=10,)r.raise_for_status()print("Enviado:", r.json()["id"])Para exercitar devolução e reclamação sem gastar reputação, troque o destinatário por um apelido de teste.
3. Listar mensagens
python
r = requests.get( "https://api.jetsend.com.br/v1/messages", headers={"Authorization": f"Bearer {KEY}"}, params={"limit": 50, "status": "delivered"}, timeout=10,)data = r.json()print(f"{len(data['data'])} mensagens, cursor={data.get('nextCursor')}")4. Criar chave de API
python
r = requests.post( "https://api.jetsend.com.br/v1/api-keys", headers={"Authorization": f"Bearer {KEY}"}, json={"name": "Produção webhook"}, timeout=10,)result = r.json()# IMPORTANTE: 'key' só aparece nesta resposta. Guarde com segurança.print("Nova API key:", result["key"])A chave aparece uma vez só. O que cada tipo de chave pode fazer está em Autenticação.
5. Verificar domínio
python
# 1) Cadastrar domíniocreate = requests.post( "https://api.jetsend.com.br/v1/domains", headers={"Authorization": f"Bearer {KEY}"}, json={"domain": "suaempresa.com.br"}, timeout=10,).json()print("Publique no DNS:", create["dnsRecords"])# 2) Após publicar DKIM/SPF/DMARC, forçar verificaçãoverify = requests.post( f"https://api.jetsend.com.br/v1/domains/{create['id']}/verify", headers={"Authorization": f"Bearer {KEY}"}, timeout=10,).json()print("Status:", verify["status"])A resposta traz os registros de DNS (CNAME de DKIM e TXT de SPF) que você precisa publicar no provedor do domínio. Depois de publicar, chame POST /v1/domains/{id}/verify para forçar a verificação. O passo a passo, com as pegadinhas de provedor brasileiro, está em Verificar domínio.