POST /banip/{ip}

Point final : POST /v1/pdapi/banip/<ip>

Auth : Jeton du porteur

Autorisation : REST.Punishments.BanIP

Objectif

Interdit une adresse IP et l'enregistre dans Banlist.json.

Aucun.

Champs JSON facultatifs : Reason string et UserId string lorsque le bannissement IP doit être associé à un utilisateur.

Field	Type	Description
`Success`	boolean	`true` when the IP ban was recorded.
`IP`	string	IP address that was banned.
`UserId`	string	Optional user ID recorded with the IP ban.
`Kicked`	integer	Number of online players kicked from that IP address.

Les corps d'erreur utilisent cette forme :

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "Human-readable message",
        "Details": {}
    }
}

HTTP	Code d'erreur	Quand ça arrive
`401`	`INVALID_TOKEN`	L'en-tête `Authorization` est manquant, mal formé ou ne correspond pas à un jeton de support configuré.
`403`	`MISSING_PERMISSION`	Le jeton est valide, mais il n'inclut pas cette autorisation de point de terminaison.
`400`	`INVALID_JSON`	Un corps de requête a été fourni, mais il n'a pas pu être analysé comme JSON.
`400`	`REQUEST_FAILED`	Le rappel du thread de jeu a généré une exception ou un résolveur player/resource partagé a échoué.
`500`	`REQUEST_TIMEOUT`	Le rappel du thread de jeu interne ne s'est pas terminé dans les 5 secondes.
`400`	`VALIDATION_FAILED`	Un champ de requête facultatif a un type JSON incorrect.

POST /v1/pdapi/banip/203.0.113.42

{
    "Reason": "Bot traffic"
}

POST /v1/pdapi/banip/198.51.100.87

{
    "Reason": "Alt account abuse",
    "UserId": "gdk_2533274898765432"
}

Arrêtez les abus répétés de la même adresse IP après examen par le personnel.
Associez UserId lorsqu'il est connu afin que la liste de bannissement soit plus facile à auditer.
Utilisez GET /banlist avec ip pour vérifier l'enregistrement actif.