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

فهرست مخاطب‌ها

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

GETapi.openemail.uk/contacts

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

GET /contacts

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

نمونه

به contacts:read نیاز دارد.

curl
curl "$OE/contacts?limit=50" -H "$AUTH"
پاسخ
{  "object": "list",  "data": [    {      "object": "contact",      "email": "[email protected]",      "name": "Ada Lovelace",      "source": "auto",      "notes": null,      "lastSeenAt": "2026-08-29T08:19:08.000Z",      "createdAt": "2026-08-01T10:00:00.000Z",      "updatedAt": "2026-08-29T08:19:08.000Z"    }  ],  "hasMore": false,  "nextCursor": null}

source وقتی manual است که کسی نشانی را ذخیره کرده باشد، در برنامه یا از راه POST /contacts، و وقتی auto است که به این دلیل ثبت شده باشد که عضوی از نویسنده به آن نامه فرستاده. این‌ها از نظر محتوا دو ادعای متفاوت‌اند (auto شاهدِ مکاتبه است و manual شاهدِ قصد) و ارزش شاخه‌زدن دارند.

ترتیب، lastSeenAt نزولی است با nullها در انتها، و سپس تازه‌ترین اول. مخاطبی که همین حالا ساخته‌اید lastSeenAt ندارد و به‌جای بالا، در انتها می‌نشیند.

دفترچه از آنِ فضای کاری است، نه از آنِ کسی که ردیفی را ذخیره کرده. نامه‌ای که از یک نشانی می‌رسد چیزی نمی‌سازد.