پرش به مستندات
API

فهرست مخاطب‌های یک گروه مخاطبان

خود مخاطب‌ها را برمی‌گرداند، نه رکوردهای عضویت را، و با همان ترتیب فهرست مخاطب‌ها: تازه‌ترین دیده‌شده‌ها اول، و مخاطب‌هایی که هرگز برایشان نامه‌ای نرفته آخر. `limit` تا ۲۰۰ می‌رود و پیش‌فرضش ۵۰ است. خواندن گروه مخاطبان پیش‌فرض از اینجا کل دفترچه نشانی‌ها را برمی‌گرداند.

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

فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا می‌کند.

GET /audiences/{id}/contacts

خود مخاطب‌ها را برمی‌گرداند، نه رکوردهای عضویت را، و با همان ترتیب فهرست مخاطب‌ها: تازه‌ترین دیده‌شده‌ها اول، و مخاطب‌هایی که هرگز برایشان نامه‌ای نرفته آخر. limit تا ۲۰۰ می‌رود و پیش‌فرضش ۵۰ است. خواندن گروه مخاطبان پیش‌فرض از اینجا کل دفترچه نشانی‌ها را برمی‌گرداند.

نمونه

تنها به 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 داشته باشد. آگاهانه صادرش کنید.

مخاطبی که در هیچ‌یک از گروه‌های شما نیست باز هم در گروه پیش‌فرض است، پس هیچ‌چیزی در دفترچه از دید این مسیر پنهان نمی‌ماند.