Liệt kê quyền
Toàn bộ bộ từ vựng, kèm câu mô tả và tiêu đề mà mỗi mục được hiển thị bên dưới.
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 /roles/permissions
Toàn bộ bộ từ vựng, kèm câu mô tả và tiêu đề mà mỗi mục được hiển thị bên dưới.
Ví dụ
Cần roles:read. Một hằng số, cùng câu trả lời cho mọi không gian làm việc, và là danh sách để xây dựng ma trận thay vì chép lại vào mã của bạn.
curl "$OE/roles/permissions" -H "$AUTH"{ "object": "list", "data": [ { "object": "permission", "id": "emails:send", "label": "Send email", "group": "mail", "scope": true }, { "object": "permission", "id": "members:write", "label": "Add and remove people, and change what they can reach", "group": "people", "scope": true }, { "object": "permission", "id": "api-keys:write", "label": "Create and revoke API keys", "group": "developer", "scope": false }, { "object": "permission", "id": "workspace:manage", "label": "Rename the workspace, remove domains and delete it", "group": "workspace", "scope": false } ]}Được đăng ký TRƯỚC /roles/{id}, nếu không permissions sẽ bị đọc như một role id và mọi yêu cầu đến nó đều trả về 404. /rules/runs có cùng ghi chú phía trên nó và /tracking/stats phía trên cái đó, cả hai đều được viết sau cùng một lỗi. Vì vậy, yêu cầu một vai trò thực sự tên là “permissions” sẽ là yêu cầu một vai trò và nhận 404, đó là câu trả lời trung thực cho những gì đã được gõ.
scope cho biết một KHÓA API có thể giữ quyền đó hay không. Năm quyền không thể (api-keys:read, api-keys:write, billing:read, billing:write và workspace:manage) vì không có endpoint nào cho chúng và khóa không phải là con người. Cờ đó là thứ cho phép một component hiển thị cả ma trận vai trò lẫn danh sách ô đánh dấu khi tạo khóa, thay vì một bản sao thứ hai được duy trì thủ công về cái nào là cái nào.
Được phục vụ thay vì chép lại, vì lý do mà danh sách trường của quy tắc đã nêu: một ma trận xây dựng từ một mảng sao chép sẽ tiếp tục hiển thị một quyền vào ngày nó bị đổi tên và không bao giờ hiển thị quyền được thêm tuần trước. group là tiêu đề mà quyền được hiển thị bên dưới và mặc định về other thay vì bị để undefined. Một quyền không ai nhìn thấy là một quyền không ai rà soát.
Thứ tự là chuẩn: đó là thứ tự mà mảng permissions của một vai trò đã lưu được trả về, nên client hiển thị danh sách này và client hiển thị một vai trò sẽ cho thấy cùng các quyền theo cùng trình tự.
Không có envelope ngoài object và data. Bộ từ vựng là đóng và ngắn, nên không có cursor và không có hasMore, khác với mọi danh sách khác trong API.