Démarrage rapide
Créez un compte, vérifiez un domaine, générez une clé d'API et envoyez votre premier e-mail avec curl ou le SDK Node.js, puis testez avec le simulateur SES.
1. Inscription
Créez un compte sur billionsend.com. Le tableau de bord s’y trouve ; l’API est à l’adresse https://api.billionsend.com.
2. Vérifier un domaine
Vous ne pouvez envoyer que depuis des domaines que vous avez vérifiés.
- Ouvrez Domaines et ajoutez un domaine qui vous appartient, par exemple
acme.dev. - Ajoutez chez votre fournisseur DNS les enregistrements affichés (DKIM et MAIL FROM).
- Cliquez sur Vérifier un domaine. La page indique quels enregistrements manquent encore.
Consultez Domaines.
3. Créer une clé d’API
Ouvrez Clés API et créez-en une. La clé bs_ n’est affichée qu’une seule fois, alors copiez-la. Une clé peut donner un accès complet ou servir uniquement à l’envoi, et peut être limitée à un domaine.
4. Envoyer un e-mail
Avec 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 avec le SDK Node.js (npm install @billionsend/node) :
import { BillionSend } from "@billionsend/node";
const bs = new BillionSend("bs_..."); // ou new BillionSend() avec BILLIONSEND_API_KEY défini
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);
Les deux renvoient { "id": "..." }. Regardez l’e-mail passer de queued à delivered sur la page E-mails. Autres langages : consultez SDK.
Tests
success@simulator.amazonses.comsimule une distribution sans envoyer d’e-mail à personne. Ajoutez une étiquette pour varier :success+signup@simulator.amazonses.com.- Les e-mails envoyés au simulateur comptent quand même dans le quota de votre forfait.
bounce@,complaint@etsuppressionlist@sur le simulateur produisent de vrais rebonds et de vraies plaintes : l’adresse est ajoutée à votre liste de suppression et l’événement déclenche vos webhooks, mais les retours du simulateur ne comptent jamais dans vos taux de rebond et de plainte. Utilisez-les à la main, pas dans des tests automatisés. Chaque adresse ne fonctionne qu’une fois ; ajoutez donc une étiquette pour en obtenir une nouvelle :bounce+2@simulator.amazonses.com.- Les adresses en
example.com, ou se terminant par.testou.invalid, ne peuvent pas recevoir d’e-mails. Un envoi vers l’une d’elles est refusé avec422(consultez Notions de base de l’API).
Étapes suivantes
- E-mails, Contacts et Campagnes.
- SDK pour votre langage.
- Référence de l’API pour chaque point de terminaison.