Liens destinataire

Ce sont les seules routes du produit qu'un destinataire atteint directement, sans clé. Vous ne les appelez jamais — vous vous assurez que votre modèle les contient.

Les liens

URLMéthodeQui l'ouvreRéponse
/api/o/{token}GETLe client de messagerie du destinataire, à l'ouvertureUn GIF transparent de 1×1
/api/t/{token}GETLe destinataire, lors d'un clicUne 302 vers la vraie destination
/api/unsubscribe/{token}POSTLe client de messagerie (désabonnement en un clic RFC 8058)Neutre, quelle que soit la valeur du jeton
/unsubscribe/{token}pageLe destinataire, depuis le pied de l'e-mailLa page de désabonnement
/subscribe/confirm/{token}pageUn nouveau contact, depuis l'e-mail d'opt-inLa 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 un status envoyé 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}/resubscribe peut revenir dessus, et jamais pour une adresse bounced.
Le jeton de désabonnement d'un contact n'est jamais exposé par /api/v1. Il n'existe que dans les e-mails envoyés à ce contact.