Vos campagnes emailing, écrites, envoyées et délivrées

Avec requests, la bibliothèque HTTP la plus courante.

import requests

BASE = 'https://app.sparrowmessage.com/api/v1'
ENTETES = {'Accept': 'application/json', 'Content-Type': 'application/json'}

# ── Authentification
auth = requests.post(f'{BASE}/login', headers=ENTETES, json={
    'email': '[email protected]',
    'password': 'votre-mot-de-passe',
}).json()

if auth.get('code') != 'OK':
    raise RuntimeError(auth.get('error', 'Authentification refusée'))

token = auth['user']['api_token']
entetes = {**ENTETES, 'Authorization': f'Bearer {token}'}

# ── Envoi unitaire
envoi = requests.post(f'{BASE}/mail/send/one', headers=entetes, json={
    'email': '[email protected]',
    'sujet': 'Votre commande #4521 est confirmée',
    'html':  '<p>Merci pour votre commande.</p>',
}).json()
print(envoi['message_id'])

# ── Envoi en masse
masse = requests.post(f'{BASE}/mail/send/bulk', headers=entetes, json={
    'emails': ['[email protected]', '[email protected]'],
    'sujet':  'Nos offres du mois',
    'html':   '<h1>Nouveautés</h1><p>Découvrez la sélection.</p>',
}).json()
print(masse['message_ids'], masse.get('mails_error'))

fetch est disponible nativement depuis Node 18.

const BASE = 'https://app.sparrowmessage.com/api/v1';
const JSON_ENTETES = { 'Accept': 'application/json', 'Content-Type': 'application/json' };

// ── Authentification
const auth = await (await fetch(`${BASE}/login`, {
  method: 'POST',
  headers: JSON_ENTETES,
  body: JSON.stringify({ email: '[email protected]', password: 'votre-mot-de-passe' })
})).json();

if (auth.code !== 'OK') throw new Error(auth.error || 'Authentification refusée');

const entetes = { ...JSON_ENTETES, Authorization: `Bearer ${auth.user.api_token}` };

// ── Envoi unitaire
const envoi = await (await fetch(`${BASE}/mail/send/one`, {
  method: 'POST',
  headers: entetes,
  body: JSON.stringify({
    email: '[email protected]',
    sujet: 'Votre commande #4521 est confirmée',
    html:  '<p>Merci pour votre commande.</p>'
  })
})).json();

// ── Envoi en masse
const masse = await (await fetch(`${BASE}/mail/send/bulk`, {
  method: 'POST',
  headers: entetes,
  body: JSON.stringify({
    emails: ['[email protected]', '[email protected]'],
    sujet:  'Nos offres du mois',
    html:   '<h1>Nouveautés</h1><p>Découvrez la sélection.</p>'
  })
})).json();

HttpClient, sans dépendance externe.

using System.Net.Http.Json;

const string Base = "https://app.sparrowmessage.com/api/v1";
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("Accept", "application/json");

// ── Authentification
var auth = await (await http.PostAsJsonAsync($"{Base}/login", new {
    email    = "[email protected]",
    password = "votre-mot-de-passe"
})).Content.ReadFromJsonAsync<JsonElement>();

if (auth.GetProperty("code").GetString() != "OK")
    throw new Exception(auth.GetProperty("error").GetString());

var token = auth.GetProperty("user").GetProperty("api_token").GetString();
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", token);

// ── Envoi unitaire
var envoi = await http.PostAsJsonAsync($"{Base}/mail/send/one", new {
    email = "[email protected]",
    sujet = "Votre commande #4521 est confirmée",
    html  = "<p>Merci pour votre commande.</p>"
});

// ── Envoi en masse
var masse = await http.PostAsJsonAsync($"{Base}/mail/send/bulk", new {
    emails = new[] { "[email protected]", "[email protected]" },
    sujet  = "Nos offres du mois",
    html   = "<h1>Nouveautés</h1><p>Découvrez la sélection.</p>"
});

java.net.http, intégré depuis Java 11.

String base = "https://app.sparrowmessage.com/api/v1";
HttpClient client = HttpClient.newHttpClient();

// ── Authentification
HttpRequest login = HttpRequest.newBuilder(URI.create(base + "/login"))
    .header("Accept", "application/json")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("""
        {"email":"[email protected]","password":"votre-mot-de-passe"}"""))
    .build();

String reponse = client.send(login, HttpResponse.BodyHandlers.ofString()).body();
String token   = new JSONObject(reponse).getJSONObject("user").getString("api_token");

// ── Envoi unitaire
HttpRequest envoi = HttpRequest.newBuilder(URI.create(base + "/mail/send/one"))
    .header("Accept", "application/json")
    .header("Content-Type", "application/json")
    .header("Authorization", "Bearer " + token)
    .POST(HttpRequest.BodyPublishers.ofString("""
        {
          "email": "[email protected]",
          "sujet": "Votre commande #4521 est confirmée",
          "html":  "<p>Merci pour votre commande.</p>"
        }"""))
    .build();

client.send(envoi, HttpResponse.BodyHandlers.ofString());

// ── Envoi en masse : "emails" est un tableau
HttpRequest masse = HttpRequest.newBuilder(URI.create(base + "/mail/send/bulk"))
    .header("Accept", "application/json")
    .header("Content-Type", "application/json")
    .header("Authorization", "Bearer " + token)
    .POST(HttpRequest.BodyPublishers.ofString("""
        {
          "emails": ["[email protected]", "[email protected]"],
          "sujet":  "Nos offres du mois",
          "html":   "<h1>Nouveautés</h1>"
        }"""))
    .build();

client.send(masse, HttpResponse.BodyHandlers.ofString());

Pour essayer depuis un terminal, avant d'écrire la moindre ligne.

# ── 1. Obtenir le jeton
curl -X POST https://app.sparrowmessage.com/api/v1/login \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"votre-mot-de-passe"}'

# Réponse :
# { "code":"OK", "token":"…", "user":{ "api_token":"…" } }

# ── 2. Envoyer un email
curl -X POST https://app.sparrowmessage.com/api/v1/mail/send/one \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer VOTRE_API_TOKEN" \
  -d '{
        "email": "[email protected]",
        "sujet": "Votre commande #4521 est confirmée",
        "html":  "<p>Merci pour votre commande.</p>"
      }'

# ── 3. Envoyer à plusieurs destinataires
curl -X POST https://app.sparrowmessage.com/api/v1/mail/send/bulk \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer VOTRE_API_TOKEN" \
  -d '{
        "emails": ["[email protected]", "[email protected]"],
        "sujet":  "Nos offres du mois",
        "html":   "<h1>Nouveautés</h1><p>Découvrez la sélection.</p>"
      }'

Si votre application sait déjà envoyer des emails, il n'y a rien à coder : il suffit de changer les paramètres du serveur sortant.

Serveur     : smtp.sparrowmessage.com
Port        : 587 (STARTTLS)  ·  465 (SSL/TLS)  ·  2525 (secours)
Sécurité    : TLS obligatoire
Utilisateur : fourni à l'ouverture du compte
Mot de passe: fourni à l'ouverture du compte
Expéditeur  : une adresse de votre domaine authentifié

# ── Exemple en PHP, avec PHPMailer
$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host       = 'smtp.sparrowmessage.com';
$mail->SMTPAuth   = true;
$mail->Username   = 'votre-identifiant';
$mail->Password   = 'votre-cle';
$mail->SMTPSecure = 'tls';
$mail->Port       = 587;
$mail->setFrom('[email protected]', 'Votre Société');
$mail->addAddress('[email protected]');
$mail->Subject = 'Votre commande #4521 est confirmée';
$mail->isHTML(true);
$mail->Body    = '<p>Merci pour votre commande.</p>';
$mail->send();

# ── Exemple en Python, sans dépendance
import smtplib
from email.message import EmailMessage

msg = EmailMessage()
msg['From']    = '[email protected]'
msg['To']      = '[email protected]'
msg['Subject'] = 'Votre commande #4521 est confirmée'
msg.set_content('Merci pour votre commande.')

with smtplib.SMTP('smtp.sparrowmessage.com', 587) as s:
    s.starttls()
    s.login('votre-identifiant', 'votre-cle')
    s.send_message(msg)