API

جلب نسخة واحدة من بث

نسخة شخص واحد: الصف نفسه الذي يعرضه `GET /broadcasts/{id}/recipients`، إضافة إلى الموضوع وHTML والنص كما تلقّاها ذلك الشخص تمامًا، مع ملء حقول الدمج ورابط إلغاء الاشتراك الخاص به.

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

ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.

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

نسخة شخص واحد: الصف نفسه الذي يعرضه GET /broadcasts/{id}/recipients، إضافة إلى الموضوع وHTML والنص كما تلقّاها ذلك الشخص تمامًا، مع ملء حقول الدمج ورابط إلغاء الاشتراك الخاص به.

مثال

يحتاج إلى emails:read. وemailId هو emailId النسخة من قائمة المستلمين. والرد مختصر هنا.

curl

curl "$OE/broadcasts/brd_5a8c1e3f7b2d94a06c8e1f3b/recipients/msg_01dad25067bc4dac966d515d" -H "$AUTH"

الاستجابة

{  "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://…"}

HTML هنا من قبل إضافة تتبع الفتح والنقر، فهو ما كتبته مع ملء حقول الدمج، وليس البايتات التي حملت بكسل التتبع والروابط المعاد كتابتها.

قيمة emailId ليست نسخة من هذا البث تعطي 404 recipient_not_found، حتى حين تسمّي رسالة أخرى في مساحة العمل.

حالات الرفض

الحالة	الرمز	متى
400	`invalid_cursor`	في قائمة المستلمين، `cursor` لم تصدره تلك القائمة.
403	`insufficient_scope`	المفتاح لا يملك `emails:read`.
404	`broadcast_not_found`	المعرّف لا يسمّي أي بث في مساحة العمل هذه، أو أن المفتاح مقصور على عناوين أو نطاقات بعينها والبث أُرسل من واحد لا يملكه.
404	`recipient_not_found`	في `GET /broadcasts/{id}/recipients/{emailId}`، قيمة `emailId` ليست نسخة من هذا البث.