API

استرجاع جمهور

الشكل نفسه الذي يظهر به صف في القائمة، مع `contactCount` محدَّث. وهذه هي الطريقة الرخيصة لمراقبة تغيّر العدّاد دون سحب جهات الاتصال التي خلفه.

GETapi.openemail.uk/audiences/{id}

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

GET /audiences/{id}

الشكل نفسه الذي يظهر به صف في القائمة، مع contactCount محدَّث. وهذه هي الطريقة الرخيصة لمراقبة تغيّر العدّاد دون سحب جهات الاتصال التي خلفه.

مثال

يتطلب audiences:read.

curl

curl "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71" -H "$AUTH"

الاستجابة

{  "object": "audience",  "id": "aud_4c1b8e2a7d9f05c36b4e8a71",  "name": "Product updates",  "description": "Customers who asked to hear about releases",  "builtin": null,  "contactCount": 3,  "createdAt": "2026-09-18T09:10:00.000Z",  "updatedAt": "2026-09-18T09:10:00.000Z"}

المعرّف الذي يعود لمساحة عمل أخرى هو 404 لا 403. فواجهة الـ API لا تخبرك أبدًا بوجود شيء في مكان لا تستطيع رؤيته.

يُقرأ الجمهور الافتراضي هنا كأي جمهور آخر، وقيمة builtin عليه هي default.