Bỏ qua tới phần tài liệu
API

Xóa một thành viên

Cả hai trục cùng lúc: vai trò, và mọi quyền cấp địa chỉ họ có ở đây.

DELETEapi.openemail.uk/members/{userId}

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.

DELETE /members/{userId}

Cả hai trục cùng lúc: vai trò, và mọi quyền cấp địa chỉ họ có ở đây.

Ví dụ

Cần members:write.

curl
curl -X DELETE "$OE/members/7fQ2mN8vBz1aRd4tYwKx7fQ2mN8vBz1a" -H "$AUTH"
Phản hồi
{  "object": "member",  "userId": "7fQ2mN8vBz1aRd4tYwKx7fQ2mN8vBz1a",  "deleted": true,  "addressesRevoked": 2}

Cả hai loại quyền cấp bị xóa cùng nhau. Chỉ xóa hàng thành viên sẽ là kết quả tệ nhất của cả hai: biến mất khỏi danh sách này, nhưng vẫn đọc được thư.

Lệnh này KHÔNG trả về 404 cho người không phải thành viên, và đó không phải là sự lỏng lẻo về id. Nhóm người mà endpoint này cần tiếp cận nhất là những người giữ quyền cấp kiểu cũ, có quyền cấp địa chỉ nhưng hoàn toàn không có hàng thành viên, nên một bước kiểm tra trước “có hàng thành viên không” sẽ từ chối đúng những người mà quyền truy cập cần bị thu hồi nhất. addressesRevoked là những gì thực sự đã xảy ra, và giá trị 0 ở đó là báo cáo trung thực về một thao tác không có tác dụng.

Lệnh này xóa họ khỏi MỘT không gian làm việc. Tài khoản OpenEmail của họ không bị ảnh hưởng, và mọi quyền truy cập họ có ở nơi khác cũng vậy.

Để thu hồi một địa chỉ và giữ người đó lại, hãy dùng DELETE /members/{userId}/addresses/{addressId}. Đó là lệnh gọi dành cho người chuyển nhóm, không phải người rời đi.