2.2 申请删除封禁记录
移除指定的封禁条目。
端点: POST /bans/del
请求头:
Text
Content-Type: application/json
请求体:
JSON
{
"token": "aBcD1234EfGh5678IjKlMnOpQrSt",
"player_id": "player123",
"ip": "192.168.1.1",
"ipv6": "2001:db8::1",
"online": true,
"mcuuid": "550e8400-e29b-41d4-a716-446655440000"
}
请求示例:
cURL:
Bash
curl -X POST https://api.ndpreforged.com/bans/del \
-H "Content-Type: application/json" \
-d '{
"token": "aBcD1234EfGh5678IjKlMnOpQrSt",
"player_id": "player123",
"ip": "192.168.1.1",
"online": false
}'
响应示例:
Success (200 OK):
JSON
{
"message": "Removed"
}
Error Responses:
| Status Code | Error Message | Description |
|---|---|---|
| 400 | Missing token | 缺少认证 Token |
| 403 | No permission | 缺乏上传权限 |
| 400 | Missing player_id or ip | 缺少必要的标识参数 |
| 400 | Delete failed | 删除操作失败 |
| 500 | Server error | 服务器内部错误 |