API
عرض عمليات البث
كل بث في مساحة العمل هذه، الأحدث أولًا، صفحة في كل مرة، ولكل منها `counts` حية. ويُبقي `audienceId` تلك التي أُرسلت إلى ذلك الجمهور، وحده أو مع غيره.
GETapi.openemail.uk/broadcasts
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
GET /broadcasts
كل بث في مساحة العمل هذه، الأحدث أولًا، صفحة في كل مرة، ولكل منها counts حية. ويُبقي audienceId تلك التي أُرسلت إلى ذلك الجمهور، وحده أو مع غيره.
مثال
يحتاج إلى emails:read. يصل limit إلى 100 وافتراضيه 25، ويأخذ cursor قيمة nextCursor من الصفحة السابقة، أي معرّف آخر بث فيها.
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 الذي لا يسمّي أي جمهور يعيد صفحة فارغة.