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

سرد جهات اتصال جمهور

جهات الاتصال نفسها بدلًا من سجلات العضوية، بالترتيب نفسه المتّبع في قائمة جهات الاتصال: الأحدث ظهورًا أولًا، وجهات الاتصال التي لم تُراسَل قط في الآخر. تصل `limit` إلى 200 وقيمتها الافتراضية 50. وقراءة الجمهور الافتراضي هنا تعيد دفتر العناوين كاملًا.

GETapi.openemail.uk/audiences/{id}/contacts

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

GET /audiences/{id}/contacts

جهات الاتصال نفسها بدلًا من سجلات العضوية، بالترتيب نفسه المتّبع في قائمة جهات الاتصال: الأحدث ظهورًا أولًا، وجهات الاتصال التي لم تُراسَل قط في الآخر. تصل limit إلى 200 وقيمتها الافتراضية 50. وقراءة الجمهور الافتراضي هنا تعيد دفتر العناوين كاملًا.

مثال

يتطلب audiences:read وحده، دون contacts:read.

curl
curl "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts?limit=50" -H "$AUTH"
الاستجابة
{  "object": "list",  "data": [    {      "object": "contact",      "email": "[email protected]",      "name": "Grace Hopper",      "source": "manual",      "notes": null,      "lastSeenAt": null,      "createdAt": "2026-09-18T09:00:00.000Z",      "updatedAt": "2026-09-18T09:00:00.000Z"    }  ],  "hasMore": false,  "nextCursor": null,  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71"}

المفتاح الذي يحمل audiences:read يقرأ العناوين الموجودة في جمهور دون أن يحمل contacts:read. أصدِره عن قصد.

جهة الاتصال التي لا تنتمي إلى أي جمهور من صنعك تبقى في الجمهور الافتراضي، فلا شيء في الدفتر خفي عن هذا المسار.