سرد جهات الاتصال
دفتر عناوين مساحة العمل، الأحدث ظهورًا أولًا، وجهات الاتصال التي لم تُراسَل قط في الآخر. وكل مفتاح على مساحة العمل يقرأ الصفوف نفسها، فجهة الاتصال التي يحفظها عضو واحد هي جهة اتصال يراها كل عضو وكل مفتاح. والتصفّح بنظام keyset: تصل `limit` إلى 200 وقيمتها الافتراضية 50، وتعود قيمة `nextCursor` بوصفها `cursor` ما دامت `hasMore` صحيحة.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
GET /contacts
دفتر عناوين مساحة العمل، الأحدث ظهورًا أولًا، وجهات الاتصال التي لم تُراسَل قط في الآخر. وكل مفتاح على مساحة العمل يقرأ الصفوف نفسها، فجهة الاتصال التي يحفظها عضو واحد هي جهة اتصال يراها كل عضو وكل مفتاح. والتصفّح بنظام keyset: تصل limit إلى 200 وقيمتها الافتراضية 50، وتعود قيمة nextCursor بوصفها cursor ما دامت hasMore صحيحة.
مثال
يتطلب contacts:read.
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 تنازليًا مع وضع القيم الفارغة في الآخر، ثم الأحدث أولًا. فجهة الاتصال التي أنشأتها لتوّك بلا lastSeenAt وتأتي في نهاية القائمة لا في أولها.
الدفتر ملك لمساحة العمل لا لمن حفظ صفًا فيه. والبريد الوارد من عنوان لا يُنشئ شيئًا.