POST /api/unsubscribe/{token}
La cible de l'en-tête List-Unsubscribe-Post (RFC 8058), appelée par Gmail et consorts quand le destinataire utilise le bouton de désabonnement de son propre client de messagerie. Limitée en débit par adresse IP.
La réponse est toujours neutre : un jeton inconnu reçoit la même réponse qu'un jeton valide. Confirmer qu'un jeton existe reviendrait à confirmer qu'une adresse figure dans une liste.
Autorisation
| Rôle dans l'organisation | Cet endpoint |
|---|---|
OWNER | Autorisé |
ADMIN | Autorisé |
MEMBER | Autorisé |
Paramètres de chemin
| Paramètre | Type | Description |
|---|---|---|
token | string | Obligatoire. Opaque, propre à chaque destinataire et à chaque envoi. Il est généré pour vous et voyage dans l'e-mail |
Exemple
bash
curl -i -X POST "https://www.agentsmail.io/api/unsubscribe/$TOKEN"Réponse
201 Created— la ressource créée.401 Unauthorized— clé absente ou invalide, ou son propriétaire a quitté l'organisation.404 Not Found— aucune ressource de ce type, ou elle appartient à une autre organisation. L'API ne confirme jamais qu'un identifiant existe à un appelant qui n'y a pas droit.429 Too Many Requests— plus de 120 requêtes en une minute pour cette clé.