سرد الأشخاص
كل من تسرده صفحة جهات الاتصال في التطبيق: جهات الاتصال المحفوظة، وكل عنوان ظهر في البريد مرسلًا أو مستلمًا لأحدث رسالة في سلسلة، مع عدد السلاسل التي يشترك فيها كلٌّ منهم مع الصندوق ووقت آخر بريد. والشخص الذي ظهر في البريد وحُفظ صفٌّ واحد. والتقسيم إلى صفحات بالمفاتيح: يصل `limit` إلى 100 وقيمته الافتراضية 25، ويعود `nextCursor` بوصفه `cursor` ما دام `hasMore` صحيحًا.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
GET /contacts/people
كل من تسرده صفحة جهات الاتصال في التطبيق: جهات الاتصال المحفوظة، وكل عنوان ظهر في البريد مرسلًا أو مستلمًا لأحدث رسالة في سلسلة، مع عدد السلاسل التي يشترك فيها كلٌّ منهم مع الصندوق ووقت آخر بريد. والشخص الذي ظهر في البريد وحُفظ صفٌّ واحد. والتقسيم إلى صفحات بالمفاتيح: يصل limit إلى 100 وقيمته الافتراضية 25، ويعود nextCursor بوصفه cursor ما دام hasMore صحيحًا.
مثال
يتطلب 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 خطأ، لأن البقية تُقرأ من البريد. ولا تُسرد أبدًا العناوين المحذوفة ولا عناوين الصندوق نفسه. والمؤشر معتم: أعِده مع sort وq وblocked نفسها، والمؤشر الذي لم يُسلَّم هو 400 invalid_cursor.