تخطَّ إلى المستندات
API

عرض عمليات البث

كل بث في مساحة العمل هذه، الأحدث أولًا، صفحة في كل مرة، ولكل منها `counts` حية. ويُبقي `audienceId` تلك التي أُرسلت إلى ذلك الجمهور، وحده أو مع غيره.

GETapi.openemail.uk/broadcasts

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

GET /broadcasts

كل بث في مساحة العمل هذه، الأحدث أولًا، صفحة في كل مرة، ولكل منها counts حية. ويُبقي audienceId تلك التي أُرسلت إلى ذلك الجمهور، وحده أو مع غيره.

مثال

يحتاج إلى emails:read. يصل limit إلى 100 وافتراضيه 25، ويأخذ cursor قيمة nextCursor من الصفحة السابقة، أي معرّف آخر بث فيها.

curl
curl "$OE/broadcasts?audienceId=aud_4c1b8e2a7d9f05c36b4e8a71&limit=10" -H "$AUTH"
الاستجابة
{  "object": "list",  "data": [    {      "object": "broadcast",      "id": "brd_5a8c1e3f7b2d94a06c8e1f3b",      "status": "sending",      "mode": "live",      "source": "api",      "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71"],      "from": "Acme <[email protected]>",      "subject": "{{firstName|Hello}}, the September release is out",      "counts": {        "recipients": 412,        "created": 250,        "skipped": 1,        "failedToQueue": 0,        "queued": 38,        "sending": 2,        "sent": 209,        "failed": 1,        "cancelled": 0      },      "lastError": null,      "scheduledAt": null,      "startedAt": "2026-09-23T12:00:02.000Z",      "completedAt": null,      "cancelledAt": null,      "createdAt": "2026-09-23T12:00:00.000Z",      "updatedAt": "2026-09-23T12:00:41.000Z"    }  ],  "hasMore": false,  "nextCursor": null}

الرسائل الفردية ليست هنا. اعرض نسخ بث واحد عبر GET /emails?broadcastId=.

المؤشر الذي لا يسمّي أي بث في مساحة العمل هذه يعطي 400 invalid_cursor. وaudienceId الذي لا يسمّي أي جمهور يعيد صفحة فارغة.