فهرست افراد
همهٔ کسانی که صفحهٔ مخاطبین برنامه فهرست میکند: مخاطبان ذخیرهشده، و هر نشانیای که در نامهها بهعنوان فرستنده یا گیرندهٔ تازهترین پیام یک رشته دیده شده است، با تعداد رشتههایی که هرکدام با صندوق مشترک دارد و زمان آخرین نامه. کسی که در نامهها دیده شده و ذخیره هم شده یک ردیف است. صفحهبندی کلیدی است: `limit` تا ۱۰۰ است و پیشفرضش ۲۵، و تا وقتی `hasMore` برابر true است، `nextCursor` بهعنوان `cursor` برمیگردد.
فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا میکند.
GET /contacts/people
همهٔ کسانی که صفحهٔ مخاطبین برنامه فهرست میکند: مخاطبان ذخیرهشده، و هر نشانیای که در نامهها بهعنوان فرستنده یا گیرندهٔ تازهترین پیام یک رشته دیده شده است، با تعداد رشتههایی که هرکدام با صندوق مشترک دارد و زمان آخرین نامه. کسی که در نامهها دیده شده و ذخیره هم شده یک ردیف است. صفحهبندی کلیدی است: limit تا ۱۰۰ است و پیشفرضش ۲۵، و تا وقتی hasMore برابر true است، nextCursor بهعنوان cursor برمیگردد.
نمونه
به contacts:read نیاز دارد. نشانیهای دیدهشده در نامهها فقط وقتی گنجانده میشوند که کلید threads:read را هم داشته باشد.
curl "$OE/contacts/people?sort=threads&limit=25" -H "$AUTH"{ "object": "list", "data": [ { "object": "person", "email": "[email protected]", "displayEmail": "[email protected]", "name": "Ada Lovelace", "saved": true, "source": "manual", "notes": "Met at the engine demo", "photoUrl": null, "threads": 42, "lastAt": "2026-09-22T16:04:11.000Z", "createdAt": "2026-08-01T10:00:00.000Z", "updatedAt": "2026-09-01T09:12:00.000Z", "blockedBy": null }, { "object": "person", "email": "[email protected]", "displayEmail": "[email protected]", "name": "Shop", "saved": false, "source": null, "notes": null, "photoUrl": null, "threads": 17, "lastAt": "2026-09-21T07:30:00.000Z", "createdAt": null, "updatedAt": null, "blockedBy": { "rule": "shop.example", "list": "blockedDomains" } } ], "hasMore": true, "nextCursor": "WyIyMDI2LTA5LTIxVDA3OjMwOjAwLjAwMFoiLDE3XQ", "seen": true}sort یکی از اینهاست: recent (پیشفرض)، تازهترین نامه در ابتدا و مخاطبان ذخیرهشدهای که هرگز در نامهها دیده نشدهاند پس از آن، name، بر اساس نام یا در نبود آن بر اساس نشانی و بیاعتنا به بزرگی و کوچکی حروف، یا threads، پررشتهترین در ابتدا. در برابری، نشانی تعیین میکند، پس پیمایش هرگز ردیفی را تکرار نمیکند یا جا نمیاندازد.
q در نامها، نشانیها و یادداشتها جستوجو میکند. email یک نشانی را میخواند و راه گرفتن تعداد رشتهها و آخرین نامهٔ یک نفر همین است. blocked=true فقط کسانی را برمیگرداند که فهرست مسدودی فضای کاری مسدودشان کرده است، از جمله قاعدههای کل دامنه، و blockedBy در هر ردیف قاعده را نام میبرد.
بدون threads:read ردیفها فقط مخاطبان ذخیرهشدهاند و seen برابر false است، چون بقیه از نامهها خوانده میشوند. نشانیهای حذفشده و نشانیهای خود صندوق هرگز فهرست نمیشوند. نشانگر مات است: آن را با همان sort، q و blocked برگردانید، و نشانگری که داده نشده 400 invalid_cursor است.