NDPR文档中心

2.4.1 申请绑定封禁附加信息

申请将附加信息（IP 地址 / UUID）绑定到现有封禁记录。

端点: POST /bans/bind

请求参数:

JSON
{
    "token": "aBcD1234EfGh5678IjKlMnOpQrSt",
    "ref_player_id": "player123",
    "add_ip": "192.168.1.100",
    "add_ipv6": "2001:db8::100",
    "online": true
}

参数	类型	必填	说明
token	string	是	认证Token
ref_player_id	string	否*	参考玩家ID（与ref_ip/ref_ipv6至少填一个）
ref_ip	string	否*	参考IP地址（与ref_player_id/ref_ipv6至少填一个）
ref_ipv6	string	否*	参考IPv6地址（与ref_player_id/ref_ip至少填一个）
add_player_id	string	否*	要添加的玩家ID（与add_ip/add_ipv6至少填一个）
add_ip	string	否*	要添加的IP地址（与add_player_id/add_ipv6至少填一个）
add_ipv6	string	否*	要添加的IPv6地址（与add_player_id/add_ip至少填一个）
online	boolean	否	是否在线，默认false
mcuuid	string	否	Minecraft UUID

约束条件: 参考信息与添加信息类型不能相同（例如，不能同时提供 ref_player_id 和 add_player_id）

请求示例:

cURL:

Bash
# 为玩家绑定 IP
curl -X POST http://localhost:5030/bans/bind \
  -H "Content-Type: application/json" \
  -d '{
    "token": "aBcD1234EfGh5678IjKlMnOpQrSt",
    "ref_player_id": "player123",
    "add_ip": "192.168.1.100",
    "add_ipv6": "2001:db8::100",
    "online": true
  }'

响应示例:

Success (200 OK):

JSON
{
    "message": "Bound"
}

Error Responses:

Status Code	Error Message	Description
400	`Missing token`	缺少认证 Token
400	`Missing reference info`	缺少参考信息
400	`Missing additional info`	缺少添加信息
400	`Reference and additional info cannot be same type`	参考与添加信息类型冲突
400	`Reference not found`	参考记录不存在
403	`No permission`	缺乏上传权限
400	`Update failed`	更新操作失败
500	`Server error`	服务器内部错误