2.2 Apply to Remove Ban Record
Remove specified ban entry.
Endpoint: POST /bans/del
Request Headers:
Text
Content-Type: application/json
Request Body:
JSON
{
"token": "aBcD1234EfGh5678IjKlMnOpQrSt",
"player_id": "player123",
"ip": "192.168.1.1",
"ipv6": "2001:db8::1",
"online": true,
"mcuuid": "550e8400-e29b-41d4-a716-446655440000"
}
Request Example:
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
}'
Response Example:
Success (200 OK):
JSON
{
"message": "Removed"
}
Error Responses:
| Status Code | Error Message | Description |
|---|---|---|
| 400 | Missing token | Missing authentication token |
| 403 | No permission | No upload permission |
| 400 | Missing player_id or ip | Missing required identifier parameters |
| 400 | Delete failed | Delete operation failed |
| 500 | Server error | Server internal error |