Documentation API

Intégrez Amg Send à vos applications : authentification par clé, envoi JSON, codes de réponse.

Base URL https://www.amgbuzines.com/api/v1

Authentification

Chaque requête doit inclure un en-tête Bearer.

HTTP Header

Authorization: Bearer <VOTRE_CLE_API>

Les clés se génèrent depuis le tableau de bord (compte requis).

POST

/api/v1/messages

Envoie un courriel transactionnel.

Corps JSON

{
  "from": "notifications@client.com",
  "to": ["destinataire@example.com"],
  "subject": "Confirmation de commande",
  "text": "Merci pour votre commande.",
  "html": "<p>Merci pour votre commande.</p>",
  "list_unsubscribe": "https://votredomaine.com/unsubscribe"
}

from : adresse d’un domaine vérifié (TXT ownership + DKIM pour la délivrabilité ; sinon l’expéditeur plateforme est utilisé). list_unsubscribe est optionnel (marketing) : URL HTTPS ou mailto:….

Idempotence

Pour éviter d’envoyer deux fois le même mail en cas de retry réseau, envoyez un en-tête Idempotency-Key (UUID recommandé, max. 128 caractères). Valable 24 h par compte.

HTTP Headers

Authorization: Bearer <VOTRE_CLE_API>
Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000

Même clé + même corps → même réponse, sans nouvel envoi (header Idempotent-Replayed: true).
Même clé + corps différent → 409 conflict.
Sans en-tête → comportement classique (chaque POST peut créer un nouvel envoi).

Réponses

202 Accepté / envoyé (ou rejeu idempotent du succès)
400 Corps invalide ou Idempotency-Key invalide
401 Clé API manquante ou invalide
403 Compte suspendu ou domaine From non vérifié
409 Idempotency-Key réutilisée avec un autre corps
429 Quota dépassé

Webhooks

Roadmap

Notifications de livraison, rebonds et plaintes : configuration prévue dans une prochaine version.