Aller au contenu
Esc
↑↓naviguer↵ouvrir⌘Japerçu
Sur cette page

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.

  1. Ouvrez Domaines et ajoutez un domaine qui vous appartient, par exemple acme.dev.
  2. Ajoutez chez votre fournisseur DNS les enregistrements affichés (DKIM et MAIL FROM).
  3. 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.com simule 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@ et suppressionlist@ 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 .test ou .invalid, ne peuvent pas recevoir d’e-mails. Un envoi vers l’une d’elles est refusé avec 422 (consultez Notions de base de l’API).

Étapes suivantes

Cette page vous a-t-elle été utile ?