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

حساب من سيصل إليه البث

الأعداد التي سيبدأ منها إرسال إلى هذه الجماهير، دون إرسال أو كتابة أي شيء: كم شخصًا سيصل إليه، وكم سيُتخطى لأنهم ألغوا اشتراكهم، وكم لأن عناوينهم محظورة. وجهة الاتصال الموجودة في عدة جماهير تُحسب مرة واحدة.

POSTapi.openemail.uk/broadcasts/preview

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

POST /broadcasts/preview

الأعداد التي سيبدأ منها إرسال إلى هذه الجماهير، دون إرسال أو كتابة أي شيء: كم شخصًا سيصل إليه، وكم سيُتخطى لأنهم ألغوا اشتراكهم، وكم لأن عناوينهم محظورة. وجهة الاتصال الموجودة في عدة جماهير تُحسب مرة واحدة.

مثال

يحتاج إلى audiences:read وحده، فالمفتاح الذي لا يستطيع الإرسال يمكنه مع ذلك أن يعرض العدد على أحد. يضم audienceIds من 1 إلى 10 معرّفات ولا يُقبل غير ذلك في المتن.

curl
curl -X POST "$OE/broadcasts/preview" -H "$AUTH" -H 'content-type: application/json' -d '{  "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71", "aud_7e3d9a1c5b2f84e06d9a3c51"]}'
الاستجابة
{  "object": "broadcast_preview",  "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71", "aud_7e3d9a1c5b2f84e06d9a3c51"],  "recipients": 412,  "unsubscribed": 9,  "suppressed": 3}

يحسب unsubscribed جهات الاتصال التي ألغت اشتراكها في كل جمهور من هذه الجماهير تنتمي إليه. وجهة الاتصال التي ما زالت مشتركة في أحدها تُحسب في recipients.

يحسب suppressed جهات الاتصال المشتركة التي عنوانها في قائمة الحظر بعد ارتداد أو شكوى أو لأن أحدًا أضافه إليها.

يُؤخذ العدد لحظة الاستدعاء. والمعرّف الذي لا يسمّي أي جمهور يعطي 404 audience_not_found.