POST /ban/{player_identifier}

Endpunkt: POST /v1/pdapi/ban/<player_identifier>

Auth: Bearer-Token

Berechtigung: REST.Punishments.Ban

Zweck

Bannt einen Benutzer und speichert den Bann in Banlist.json. Das Ziel kann gekickt werden, wenn es aktuell online ist.

Pfadparameter

player_identifier: UserId, PlayerUID oder eine andere unterstützte Spielerkennung.

Query-Parameter

Keine.

Request-Body

Optionale JSON-Felder: Reason als String und IP als Boolean. Setze IP nur dann auf true, wenn auch die aufgelöste IP-Adresse gebannt werden soll.

Antwortschema

Schema der 200-Antwort

Feld	Typ	Beschreibung
`Success`	boolean	`true`, wenn die Sperre gespeichert wurde.
`UserId`	string	Gesperrte Benutzer-ID.
`IP`	boolean	Gibt an, ob die Anfrage auch eine IP-Adresse gesperrt hat.
`BannedIP`	string	Gesperrte IP-Adresse oder eine leere Zeichenfolge, wenn keine IP gesperrt wurde.
`Kicked`	integer	Anzahl der durch die Sperre vom Server entfernten Online-Spieler.

Fehlerantworten

Fehlerantworten verwenden dieses Format:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "Für Menschen lesbare Nachricht",
        "Details": {}
    }
}

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`	Ein optionales Anfragefeld besitzt den falschen JSON-Typ.
`400`	`IP_UNAVAILABLE`	`IP` war `true`, aber der Server konnte für den Zielbenutzer keine IP-Adresse ermitteln.

Beispiele

Einen Steam-Benutzer sperren

POST /v1/pdapi/ban/steam_76561198012345678

{
    "Reason": "Chargeback fraud"
}

Einen PS5-Benutzer und seine ermittelte IP sperren

POST /v1/pdapi/ban/ps5_0f4b8c2d91aa34ef

{
    "Reason": "Ban evasion",
    "IP": true
}

Szenarien

Einen Spieler nach moderativer Prüfung anhand seiner UserId sperren.
Einen eindeutigen Grund angeben, damit spätere Teammitglieder den Sperrlisteneintrag nachvollziehen können.
Nutze GET /banlist, um den aktiven Eintrag zu prüfen. Bannbezogene Daten werden nicht mehr in Config.json verwaltet.