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

سرد الجماهير

الجمهور قائمة مسمّاة من جهات الاتصال في مساحة العمل هذه. كل جهة اتصال تنتمي إلى الجمهور الافتراضي المدمج منذ لحظة وجودها، و`builtin` هو ما يُسمّي ذلك الصف؛ أما البقية فهي لك تصنعها وتملؤها وتحذفها. يأتي الجمهور الافتراضي أولًا، ثم البقية من الأحدث إلى الأقدم. وهذه النسخة تدير القوائم ولا ترسل إليها شيئًا، فلا توجد نقطة نهاية للبث تبحث عنها.

GETapi.openemail.uk/audiences

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

GET /audiences

الجمهور قائمة مسمّاة من جهات الاتصال في مساحة العمل هذه. كل جهة اتصال تنتمي إلى الجمهور الافتراضي المدمج منذ لحظة وجودها، وbuiltin هو ما يُسمّي ذلك الصف؛ أما البقية فهي لك تصنعها وتملؤها وتحذفها. يأتي الجمهور الافتراضي أولًا، ثم البقية من الأحدث إلى الأقدم. وهذه النسخة تدير القوائم ولا ترسل إليها شيئًا، فلا توجد نقطة نهاية للبث تبحث عنها.

مثال

يتطلب audiences:read. وتصل limit إلى 100 وقيمتها الافتراضية 25.

curl
curl "$OE/audiences" -H "$AUTH"
الاستجابة
{  "object": "list",  "data": [    {      "object": "audience",      "id": "aud_9f2c4b7e1a0d63d84c5f2e7b",      "name": "All contacts",      "description": null,      "builtin": "default",      "contactCount": 412,      "createdAt": "2026-08-01T10:00:00.000Z",      "updatedAt": "2026-08-01T10:00:00.000Z"    }  ],  "hasMore": false,  "nextCursor": null}

تفرّع على builtin لا على الاسم. فالجمهور الافتراضي يستطيع أي شخص إعادة تسميته، واسمه هو الشيء الوحيد الذي يتغيّر فيه.

يُحسم الجمهور الافتراضي عند أول قراءة، لذا فإن مساحة العمل التي لم تُنشئ جمهورًا قط تسرد صفًا واحدًا بالضبط.

يُحسب contactCount لحظة القراءة، لذا تختلف قراءتان على طرفي عملية إنشاء بمقدار واحد. والأسماء ليست فريدة، فخزّن المعرّفات لا الأسماء.