Rechte

Base: /api/permissions

Benutzer, Gruppen und OP in permissions.json

Verarbeitung: PermissionsHandler

Endpunkte

GET /api/permissions Rechte abrufen GET /api/permissions/groups Gruppen auflisten POST /api/permissions/op OP per UUID vergeben DELETE /api/permissions/op/{uuid} OP per UUID entziehen POST /api/permissions/user/group Benutzer in Gruppe aufnehmen DELETE /api/permissions/user/group Benutzer aus Gruppe entfernen POST /api/permissions/groups Gruppe anlegen DELETE /api/permissions/groups/{name} Gruppe löschen

GET /api/permissions

Rechte abrufen

Liefert alle Benutzer mit ihren Gruppen und alle Gruppen mit ihren Rechten.

Antwort-Beispiel

{
  "users": [
    {
      "uuid": "1234...",
      "groups": [
        "OP"
      ]
    }
  ],
  "groups": {
    "OP": [
      "*"
    ]
  }
}

cURL

curl -X GET 'http://localhost:5550/api/permissions' \
  -H 'X-Admin-Token: YOUR_TOKEN'

Internes Verhalten

Liest permissions.json.

GET /api/permissions/groups

Gruppen auflisten

Liefert nur die Gruppen.

Antwort-Beispiel

{
  "OP": [
    "*"
  ],
  "Builder": [
    "build.*"
  ]
}

cURL

curl -X GET 'http://localhost:5550/api/permissions/groups' \
  -H 'X-Admin-Token: YOUR_TOKEN'

Internes Verhalten

Liest die Gruppen aus permissions.json.

POST /api/permissions/op

OP per UUID vergeben

Gibt einem Spieler per UUID Operator-Rechte.

Anfragekörper

Feld	Typ	Pflicht	Beschreibung
`uuid`	string	Ja	Spieler-UUID

Antwort-Beispiel

{
  "success": true,
  "uuid": "1234...",
  "action": "op"
}

cURL

curl -X POST 'http://localhost:5550/api/permissions/op' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"uuid": "3f1c2b7e-8d4a-4c1e-9b2f-6a5d0e7c9b11"}'

Internes Verhalten

Schreibt permissions.json und protokolliert ein Rechte-Ereignis.

DELETE /api/permissions/op/{uuid}

OP per UUID entziehen

Entzieht die Operator-Rechte.

Parameter

Name	Typ	Pflicht	Beschreibung
`uuid`	string	Ja	Spieler-UUID

Antwort-Beispiel

{
  "success": true,
  "uuid": "1234...",
  "action": "deop"
}

cURL

curl -X DELETE 'http://localhost:5550/api/permissions/op/3f1c2b7e-8d4a-4c1e-9b2f-6a5d0e7c9b11' \
  -H 'X-Admin-Token: YOUR_TOKEN'

Internes Verhalten

Schreibt permissions.json und protokolliert ein Rechte-Ereignis.

POST /api/permissions/user/group

Benutzer in Gruppe aufnehmen

Nimmt einen Spieler in eine Gruppe auf.

Anfragekörper

Feld	Typ	Pflicht	Beschreibung
`uuid`	string	Ja	Spieler-UUID
`group`	string	Ja	Gruppenname

Antwort-Beispiel

{
  "success": true,
  "uuid": "1234...",
  "group": "Builder"
}

cURL

curl -X POST 'http://localhost:5550/api/permissions/user/group' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"uuid": "3f1c2b7e-8d4a-4c1e-9b2f-6a5d0e7c9b11", "group": "Moderator"}'

Internes Verhalten

Schreibt permissions.json.

DELETE /api/permissions/user/group

Benutzer aus Gruppe entfernen

Nimmt einen Spieler aus einer Gruppe heraus.

Anfragekörper

Feld	Typ	Pflicht	Beschreibung
`uuid`	string	Ja	Spieler-UUID
`group`	string	Ja	Gruppenname

Antwort-Beispiel

{
  "success": true,
  "uuid": "1234...",
  "group": "Builder"
}

cURL

curl -X DELETE 'http://localhost:5550/api/permissions/user/group' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"uuid": "3f1c2b7e-8d4a-4c1e-9b2f-6a5d0e7c9b11", "group": "Moderator"}'

Internes Verhalten

Schreibt permissions.json.

POST /api/permissions/groups

Gruppe anlegen

Legt eine Rechtegruppe an.

Anfragekörper

Feld	Typ	Pflicht	Beschreibung
`name`	string	Ja	Gruppenname
`permissions`	array	Nein	Rechte

Antwort-Beispiel

{
  "success": true,
  "group": "Builder"
}

cURL

curl -X POST 'http://localhost:5550/api/permissions/groups' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"name": "Moderator", "permissions": ["hytale.command.kick"]}'

Internes Verhalten

Schreibt permissions.json.

DELETE /api/permissions/groups/{name}

Gruppe löschen

Löscht eine Rechtegruppe.

Parameter

Name	Typ	Pflicht	Beschreibung
`name`	string	Ja	Gruppenname

Antwort-Beispiel

{
  "success": true,
  "group": "Builder"
}

cURL

curl -X DELETE 'http://localhost:5550/api/permissions/groups/Moderator' \
  -H 'X-Admin-Token: YOUR_TOKEN'

Internes Verhalten

Schreibt permissions.json.