REST-API: Permissions
Erzeugt aus dem OpenAPI-Dokument des Daemons. Konventionen, Anmeldung, der CSRF-Header und der WebSocket stehen unter API.
GET /api/groups/{groupId}/grants
Abschnitt betitelt „GET /api/groups/{groupId}/grants“Administrators only. Every grant of the group; its members have them all.
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
groupId |
path | integer (int64) | ja |
Antworten
- 200:
application/json: GroupGrants
Jeder Fehler antwortet mit Problem Details (application/problem+json) und einem stabilen Code aus der Fehlerreferenz.
PUT /api/groups/{groupId}/grants
Abschnitt betitelt „PUT /api/groups/{groupId}/grants“Administrators only. Replaces every grant of the group. Refused when no active administrator would be left.
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
groupId |
path | integer (int64) | ja |
Anfrage-Body: application/json: GrantsRequest
Antworten
- 200:
application/json: GroupGrants
Jeder Fehler antwortet mit Problem Details (application/problem+json) und einem stabilen Code aus der Fehlerreferenz.
GET /api/permissions/catalog
Abschnitt betitelt „GET /api/permissions/catalog“Administrators only. The special rights, file protocols and apps a grant can name, in the order the editors show them.
Antworten
- 200:
application/json: PermissionCatalog
Jeder Fehler antwortet mit Problem Details (application/problem+json) und einem stabilen Code aus der Fehlerreferenz.
GET /api/users/{userId}/grants
Abschnitt betitelt „GET /api/users/{userId}/grants“Administrators only. The user’s own grants, the grants its groups give it (the built-in group users included) and what it may do in the end.
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
userId |
path | integer (int64) | ja |
Antworten
- 200:
application/json: UserGrants
Jeder Fehler antwortet mit Problem Details (application/problem+json) und einem stabilen Code aus der Fehlerreferenz.
PUT /api/users/{userId}/grants
Abschnitt betitelt „PUT /api/users/{userId}/grants“Administrators only. Replaces every grant of the user. Refused when no active administrator would be left; applies to the user’s next request and is pushed to its desktop.
Parameter
| Name | Ort | Typ | Pflicht | Beschreibung |
|---|---|---|---|---|
userId |
path | integer (int64) | ja |
Anfrage-Body: application/json: GrantsRequest
Antworten
- 200:
application/json: UserGrants
Jeder Fehler antwortet mit Problem Details (application/problem+json) und einem stabilen Code aus der Fehlerreferenz.