Llista els permisos
Tot el vocabulari, amb la frase i el títol sota el qual es renderitza cada entrada.
Executa la crida real contra el teu espai de treball, amb la teva pròpia clau.
GET /roles/permissions
Tot el vocabulari, amb la frase i el títol sota el qual es renderitza cada entrada.
Exemple
Necessita roles:read. Una constant, la mateixa resposta per a tots els espais de treball, i la llista a partir de la qual construir una matriu en comptes de transcriure-la al teu propi codi.
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 } ]}Registrat ABANS de /roles/{id}, o permissions es llegeix com un id de rol i totes les peticions que s'hi facin donen 404. /rules/runs porta la mateixa nota a sobre i /tracking/stats una altra, totes dues escrites després del mateix error. Demanar un rol que realment es digui «permissions» demana, doncs, un rol i rep un 404, que és la resposta honesta al que s'ha escrit.
scope diu si una CLAU D'API pot tenir el permís o no. Cinc no poden (api-keys:read, api-keys:write, billing:read, billing:write i workspace:manage) perquè no hi ha cap endpoint per a cap d'ells i una clau no és una persona. Aquest indicador és el que permet que un sol component renderitzi tant la matriu de rols com la llista de caselles de creació de claus, en comptes d'una segona còpia mantinguda a mà de quin és quin.
Servit en comptes de transcrit, pel mateix motiu que dona la llista de camps de les regles: una matriu construïda a partir d'un array copiat continua oferint un permís el dia que se'n reanomena un i no ofereix mai el que es va afegir la setmana passada. group és el títol sota el qual es renderitza i, si no n'hi ha, recau en other en comptes de sortir undefined. Un permís que ningú no pot veure és un permís que ningú no audita.
L'ordre és canònic: és l'ordre en què torna l'array permissions d'un rol emmagatzemat, de manera que un client que renderitza aquesta llista i un client que renderitza un rol mostren els mateixos permisos en la mateixa seqüència.
Cap embolcall més enllà d'object i data. El vocabulari és tancat i curt, de manera que no hi ha cursor ni hasMore, a diferència de qualsevol altra llista de l'API.