Les liens
| URL | Méthode | Qui l'ouvre | Réponse |
|---|---|---|---|
/api/o/{token} | GET | Le client de messagerie du destinataire, à l'ouverture | Un GIF transparent de 1×1 |
/api/t/{token} | GET | Le destinataire, lors d'un clic | Une 302 vers la vraie destination |
/api/unsubscribe/{token} | POST | Le client de messagerie (désabonnement en un clic RFC 8058) | Neutre, quelle que soit la valeur du jeton |
/unsubscribe/{token} | page | Le destinataire, depuis le pied de l'e-mail | La page de désabonnement |
/subscribe/confirm/{token} | page | Un nouveau contact, depuis l'e-mail d'opt-in | La page de confirmation |
Confirmation du double opt-in — /subscribe/confirm/{token}
Un contact créé par le parcours double opt-in arrive en pending et reçoit un e-mail de confirmation. Ouvrir le lien le fait passer en subscribed. Jusque-là, il fait partie de l'audience mais ne reçoit rien.
Il n'existe aucun endpoint public d'inscription. Un contact entre dans une audience par
POST /api/v1/lists/{listId}/contacts, avec une clé d'API — voir l'API Audience. La confirmation est la seule moitié publique du parcours, et c'est une page, pas une API. Personne ne peut pousser des contacts dans vos listes depuis l'extérieur.Ce que cela implique pour l'API
Le statut d'un contact est le point de rencontre entre ces liens publics et l'API, et l'API s'efface volontairement :PATCH /api/v1/contacts/{contactId}ignore unstatusenvoyé dans le corps. L'état d'abonnement ne change que par des actes explicites.- Un upsert ne ressuscite jamais en silence un contact désabonné.
- Un destinataire qui s'est désabonné depuis son client de messagerie l'est pour de bon ; seul
POST /api/v1/contacts/{contactId}/resubscribepeut revenir dessus, et jamais pour une adressebounced.
/api/v1. Il n'existe que dans les e-mails envoyés à ce contact.