Aller à la documentation
API

Récupérer une copie d'une diffusion

La copie d'une personne : la même ligne que liste `GET /broadcasts/{id}/recipients`, plus l'objet, le HTML et le texte exactement tels que cette personne les a reçus, avec les champs de fusion remplis et son propre lien de désabonnement.

GETapi.openemail.uk/broadcasts/{id}/recipients/{emailId}

Exécute le véritable appel sur votre espace de travail, avec votre propre clé.

GET /broadcasts/{id}/recipients/{emailId}

La copie d'une personne : la même ligne que liste GET /broadcasts/{id}/recipients, plus l'objet, le HTML et le texte exactement tels que cette personne les a reçus, avec les champs de fusion remplis et son propre lien de désabonnement.

Exemple

Exige emails:read. emailId est l'emailId de la copie, issu de la liste des destinataires. La réponse est abrégée ici.

curl
curl "$OE/broadcasts/brd_5a8c1e3f7b2d94a06c8e1f3b/recipients/msg_01dad25067bc4dac966d515d" -H "$AUTH"
Réponse
{  "object": "broadcast_recipient",  "emailId": "msg_01dad25067bc4dac966d515d",  "email": "[email protected]",  "name": "Ada Lovelace",  "status": "sent",  "deliveredAt": "2026-09-23T12:00:11.000Z",  "opens": 3,  "clicks": 1,  "unsubscribedAt": null,  "subject": "Ada, the September release is out",  "html": "<p>Hi Ada,</p><p>Here is what changed this month.</p>",  "text": "Hi Ada, here is what changed this month. Unsubscribe: https://…"}

Le HTML est celui d'avant l'ajout du suivi des ouvertures et des clics : c'est donc ce que vous avez écrit, avec les champs de fusion remplis, et non les octets qui portaient le pixel de suivi et les liens réécrits.

Un emailId qui n'est pas une copie de cette diffusion donne un 404 recipient_not_found, même s'il désigne un autre e-mail de l'espace de travail.

Refus

StatutCodeQuand
400invalid_cursorSur la liste des destinataires, un cursor que cette liste n'a pas fourni.
403insufficient_scopeLa clé ne détient pas emails:read.
404broadcast_not_foundL'id ne désigne aucune diffusion de cet espace de travail, ou la clé est limitée à certaines adresses ou certains domaines et la diffusion est partie d'une adresse qu'elle ne détient pas.
404recipient_not_foundSur GET /broadcasts/{id}/recipients/{emailId}, un emailId qui n'est pas une copie de cette diffusion.