Suivi des ouvertures

GET /api/o/{token} Le pixel enregistre l'ouverture et renvoie le GIF. Toute erreur est absorbée : un jeton inconnu, une base de données indisponible, n'importe quoi — la réponse reste un 200 et une image valide. Un e-mail déjà arrivé dans une boîte de réception ne doit jamais afficher une image cassée à cause d'un incident de notre côté.

Autorisation

Rôle dans l'organisationCet endpoint
OWNERAutorisé
ADMINAutorisé
MEMBERAutorisé
Une clé porte le rôle que son créateur détient dans cette organisation — jamais un rôle sur AgentsMail lui-même. Voir Clés d'API.

Paramètres de chemin

ParamètreTypeDescription
tokenstringObligatoire. Opaque, propre à chaque destinataire et à chaque envoi. Il est généré pour vous et voyage dans l'e-mail

Exemple

bash
curl -i "https://www.agentsmail.io/api/o/$TOKEN"

Réponse

  • 200 OK — l'appel a réussi.
  • 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é.

Voir aussi