Lấy thông tin một thành viên
Một người, vai trò và các địa chỉ của họ, theo id tài khoản.
Chạy lệnh gọi thật với không gian làm việc của bạn, bằng khóa của chính bạn.
GET /members/{userId}
Một người, vai trò và các địa chỉ của họ, theo id tài khoản.
Ví dụ
Cần members:read. Theo USER ID: userId lấy từ danh sách, không phải địa chỉ email của họ.
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"}Ở đây không có tra cứu theo email. POST /members là lệnh gọi duy nhất nhận email, vì đó là lệnh gọi duy nhất mà bên gọi thực sự chưa có user id.
Một user id không thuộc không gian làm việc này là một lỗi 404 thông thường. Đây là trường hợp duy nhất trong tài nguyên này mang nghĩa rõ ràng “không có tài nguyên như vậy”. Cùng điều kiện đó phát sinh từ một thao tác ghi không thể đọc lại được sẽ ánh xạ thành 422, điều đúng ở đó và sai ở đây.
Được đọc từ danh sách thành viên đầy đủ thay vì bằng truy vấn một hàng, một cách có chủ đích: một thành viên là HỢP của một hàng vai trò và một tập quyền cấp địa chỉ, mỗi thứ đều có thể tồn tại mà không cần thứ kia, và phép hợp đó được tính toán ở đúng một nơi. Truy vấn một hàng sẽ là cách triển khai thứ hai của nó, và nhóm người mà nó lặng lẽ bỏ sót là những người giữ quyền cấp kiểu cũ, những người chiếm phần lớn bảng hiện nay.