POST /unban/{user_id}
Endpunkt: POST /v1/pdapi/unban/<user_id>
Auth: Bearer-Token
Berechtigung: REST.Punishments.Unban
Zweck
Unbans a user ID in Banlist.json.
Pfadparameter
user_id: User ID to unban.
Query-Parameter
Keine.
Request-Body
Optionales JSON-Feld: Reason als String.
Antwortschema
200 response schema
| Field | Type | Description |
|---|---|---|
Success |
boolean | true when the active user ban was removed. |
UserId |
string | User ID that was unbanned. |
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 |
BAN_NOT_FOUND |
Die angegebene user_id ist nicht aktiv gebannt. |
Beispiele
Unban a Steam user
Unban a PS5 user with default reason
Szenarien
- Remove a user ban after appeal approval.
- Keep a reason for the audit trail.
- Nutze GET /banlist mit
userIdoderq, um das Ergebnis zu prüfen.