跳转至

POST /unbanip/{ip}

端点: POST /v1/pdapi/unbanip/<ip>

认证: Bearer 令牌

权限: REST.Punishments.UnbanIP

用途

Unbans an IP address in Banlist.json.

路径参数

  • ip: IP address to unban.

查询参数

无。

请求体

可选 JSON 字段:字符串 Reason

响应结构

200 response schema

Field Type Description
Success boolean true when the active IP ban was removed.
IP string IP address that was unbanned.

错误响应

错误响应使用以下格式:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "人类可读的消息",
        "详情": {}
    }
}
HTTP 错误代码 发生条件
401 INVALID_TOKEN Authorization 头缺失、格式错误,或与配置的 Bearer 令牌不匹配。
403 MISSING_PERMISSION 令牌有效,但不包含此端点权限。
400 INVALID_JSON 提供了请求体,但无法解析为 JSON。
400 REQUEST_FAILED 游戏线程回调抛出异常,或共享玩家/资源解析器失败。
500 REQUEST_TIMEOUT 内部游戏线程回调未在 5 秒内完成。
400 VALIDATION_FAILED An optional request field has the wrong JSON type.
404 BAN_NOT_FOUND 提供的 ip 当前未被封禁。

示例

Unban an IP with reason

POST /v1/pdapi/unbanip/203.0.113.42
{
    "Reason": "Temporary block expired"
}

Unban an IP with default reason

POST /v1/pdapi/unbanip/198.51.100.87
{}

使用场景

  • Remove an IP ban after investigation.
  • 当玩家解除账号封禁后仍被阻止,且原因是 IP 记录仍处于活动状态时使用。
  • 使用带 ipGET /banlist 验证结果。