POST /kick/{player_identifier}
Endpunkt: POST /v1/pdapi/kick/<player_identifier>
Auth: Bearer-Token
Berechtigung: REST.Punishments.Kick
Zweck
Kickt einen Online-Spieler, ohne einen Banneintrag zu erstellen.
Pfadparameter
player_identifier:UserId,PlayerUID, or another supported player identifier.
Query-Parameter
Keine.
Request-Body
Optionales JSON-Feld: Reason als String.
Antwortschema
200 response schema
| Field | Type | Description |
|---|---|---|
Success |
boolean | true when the player was kicked. |
UserId |
string | User ID that was kicked. |
Fehlerantworten
Fehlerantworten verwenden dieses Format:
| HTTP | Fehlercode | Wann es passiert |
|---|---|---|
401 |
INVALID_TOKEN |
Der Authorization-Header fehlt, ist fehlerhaft oder passt zu keinem konfigurierten Bearer-Token. |
403 |
MISSING_PERMISSION |
Das Token ist gültig, enthält aber nicht die Berechtigung für diesen Endpunkt. |
400 |
INVALID_JSON |
Ein Request-Body wurde gesendet, konnte aber nicht als JSON gelesen werden. |
400 |
REQUEST_FAILED |
Der Game-Thread-Callback hat eine Ausnahme ausgelöst oder ein gemeinsamer Spieler-/Ressourcen-Resolver ist fehlgeschlagen. |
500 |
REQUEST_TIMEOUT |
Der interne Game-Thread-Callback wurde nicht innerhalb von 5 Sekunden abgeschlossen. |
400 |
VALIDATION_FAILED |
An optional request field has the wrong JSON type. |
404 |
PLAYER_NOT_FOUND |
Der Zielspieler ist nicht online oder konnte nicht gefunden werden. |
Beispiele
Kick a GDK player with reason
Kick a Steam player with default reason
Szenarien
- Remove a player before maintenance.
- Kick a stuck player so they can reconnect.
- Nutze stattdessen POST /ban, wenn der Spieler nicht zurückkehren dürfen soll.