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

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

یک گروه مخاطبان، فهرستی نام‌دار از مخاطب‌های این فضای کاری است. هر مخاطب از همان لحظه‌ای که وجود پیدا می‌کند در گروه پیش‌فرضِ درون‌ساخت است، و `builtin` همان چیزی است که آن ردیف را نام می‌برد؛ بقیه از آنِ شماست تا بسازید، پر کنید و حذف کنید. گروه پیش‌فرض اول می‌آید، سپس بقیه از تازه‌ترین. این نسخه فهرست‌ها را مدیریت می‌کند و چیزی برایشان نمی‌فرستد، پس نقطه پایانی همگانی‌ای برای گشتن وجود ندارد.

GETapi.openemail.uk/audiences

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

GET /audiences

یک گروه مخاطبان، فهرستی نام‌دار از مخاطب‌های این فضای کاری است. هر مخاطب از همان لحظه‌ای که وجود پیدا می‌کند در گروه پیش‌فرضِ درون‌ساخت است، و builtin همان چیزی است که آن ردیف را نام می‌برد؛ بقیه از آنِ شماست تا بسازید، پر کنید و حذف کنید. گروه پیش‌فرض اول می‌آید، سپس بقیه از تازه‌ترین. این نسخه فهرست‌ها را مدیریت می‌کند و چیزی برایشان نمی‌فرستد، پس نقطه پایانی همگانی‌ای برای گشتن وجود ندارد.

نمونه

به audiences:read نیاز دارد. limit تا ۱۰۰ می‌رود و پیش‌فرضش ۲۵ است.

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 در همان لحظهٔ خواندن شمرده می‌شود، پس دو خواندن در دو سوی یک ساخت، یکی اختلاف دارند. نام‌ها یکتا نیستند، پس به‌جای نام‌ها شناسه‌ها را ذخیره کنید.