جلب عضو
شخص واحد، ودوره وعناوينه، بمعرّف الحساب.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
GET /members/{userId}
شخص واحد، ودوره وعناوينه، بمعرّف الحساب.
مثال
يتطلب members:read. بمعرّف المستخدم: قيمة userId من القائمة، لا عنوان بريده الإلكتروني.
curl "$OE/members/nQ8vBz1aRd4tYwKx7fQ2mN8vBz1aRd4t" -H "$AUTH"{ "object": "member", "userId": "nQ8vBz1aRd4tYwKx7fQ2mN8vBz1aRd4t", "email": "[email protected]", "name": "Sam Okonjo", "image": null, "role": { "id": "role_2b81de079c1f0a4b7e05d386", "name": "Support", "builtin": null }, "implied": false, "permissions": [ "emails:send", "emails:read", "threads:read", "threads:write", "labels:read", "labels:write", "contacts:read" ], "addresses": [ { "addressId": "2b81de07-9c1f-4a4b-8e05-d3862c1f0a44", "address": "[email protected]", "access": "member" } ], "createdAt": "2026-08-12T14:20:00.000Z"}لا يوجد بحث بالبريد الإلكتروني هنا. POST /members هو النداء الوحيد الذي يقبل عنوانًا، لأنه النداء الوحيد الذي لا يملك مُناديه فعلًا معرّف مستخدم بعد.
معرّف مستخدم لا ينتمي إلى مساحة العمل هذه هو 404 عادي. وهي الحالة الوحيدة في هذا المورد التي تعني بلا لبس «لا يوجد مثل هذا المورد». والحالة نفسها حين تنشأ عن كتابة لم يمكن قراءتها بعد ذلك تُترجَم إلى 422، وهي الصحيحة هناك والخاطئة هنا.
يُقرأ من قائمة الأعضاء الكاملة لا عبر استعلام صف واحد، وذلك عن قصد: العضو هو اتحاد صف دور ومجموعة من منح العناوين، وكلٌّ منهما قد يوجد دون الآخر، وهذا الاتحاد يُحسَب في مكان واحد بالضبط. واستعلام الصف الواحد كان سيصير تطبيقًا ثانيًا له، والفئة التي كان سيغفلها بصمت هي أصحاب المنح القديمة، وهم معظم الجدول اليوم.