Início rápido
Envie seu primeiro e-mail em poucos minutos.
1. Cadastre-se
Crie uma conta em billionsend.com. O painel fica lá; a API fica em https://api.billionsend.com.
2. Verifique um domínio
Você só pode enviar de domínios que verificou.
- Abra Domínios e adicione um domínio seu, por exemplo
acme.dev. - Adicione no seu provedor de DNS os registros mostrados (DKIM e MAIL FROM).
- Clique em Verificar domínio. A página mostra quais registros ainda faltam.
Veja Domínios.
3. Crie uma chave de API
Abra Chaves de API e crie uma. A chave bs_ aparece uma única vez, então copie. Uma chave pode ter acesso total ou apenas de envio, e pode ser limitada a um domínio.
4. Envie um e-mail
Com curl:
curl -X POST https://api.billionsend.com/emails \
-H "Authorization: Bearer bs_..." \
-H "Content-Type: application/json" \
-d '{
"from": "Acme <onboarding@acme.dev>",
"to": ["success@simulator.amazonses.com"],
"subject": "Hello from BillionSend",
"html": "<strong>It works!</strong>"
}'
Ou com o SDK para Node.js (npm install @billionsend/node):
import { BillionSend } from "@billionsend/node";
const bs = new BillionSend("bs_..."); // or new BillionSend() with BILLIONSEND_API_KEY set
const { data, error } = await bs.emails.send({
from: "Acme <onboarding@acme.dev>",
to: ["success@simulator.amazonses.com"],
subject: "Hello from BillionSend",
html: "<strong>It works!</strong>",
});
if (error) console.error(error.name, error.message);
else console.log("sent", data.id);
Ambos retornam { "id": "..." }. Veja o e-mail passar de queued para delivered na página E-mails. Outras linguagens: veja SDKs.
Testes
success@simulator.amazonses.comsimula uma entrega sem enviar e-mail a ninguém. Acrescente um rótulo para variar:success+signup@simulator.amazonses.com.- E-mails para o simulador também contam na cota do seu plano.
bounce@,complaint@esuppressionlist@no simulador geram rejeições e reclamações reais: o endereço entra na sua lista de supressão e conta nas suas taxas de rejeição e de reclamação. Use-os à mão, não em testes automatizados. Cada endereço funciona uma vez, então acrescente um rótulo para um novo:bounce+2@simulator.amazonses.com.- Endereços em
example.com, ou terminados em.testou.invalid, não recebem e-mail. Um envio para um deles é recusado com422(veja o Básico da API).
Próximos passos
- E-mails, Contatos e Transmissões.
- SDKs para a sua linguagem.
- Referência da API com todos os endpoints.