POST /unbanip/{ip}

Ponto final: POST /v1/pdapi/unbanip/<ip>

Autenticação: Token do portador

Permissão: REST.Punishments.UnbanIP

Objetivo

Desbane um endereço IP em Banlist.json.

Parâmetros de caminho

• ip: endereço IP para cancelar o banimento.

Parâmetros de consulta

Nenhum.

Solicitar corpo

Campo opcional JSON: Reason string.

Esquema de resposta

200 response schema

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

Respostas de erro

Os corpos de erro usam esta forma:

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

HTTP	Código de erro	Quando isso acontece
401	INVALID_TOKEN	O cabeçalho Authorization está ausente, malformado ou não corresponde a um token de portador configurado.
403	MISSING_PERMISSION	O token é válido, mas não inclui essa permissão de endpoint.
400	INVALID_JSON	Um corpo de solicitação foi fornecido, mas não pôde ser analisado como JSON.
400	REQUEST_FAILED	O retorno de chamada do thread do jogo gerou uma exceção ou um resolvedor player/resource compartilhado falhou.
500	REQUEST_TIMEOUT	O retorno de chamada do thread de jogo interno não foi concluído em 5 segundos.
400	VALIDATION_FAILED	Um campo de solicitação opcional tem o tipo JSON errado.
404	BAN_NOT_FOUND	O ip fornecido não foi banido ativamente.

Exemplos

Desbanir um IP com razão

POST /v1/pdapi/unbanip/203.0.113.42

{
    "Reason": "Temporary block expired"
}

Desbanir um IP com motivo padrão

POST /v1/pdapi/unbanip/198.51.100.87

{}

Cenários

• Remova um banimento de IP após investigação.
• Use quando um jogador ainda estiver bloqueado após o cancelamento do banimento no nível do usuário porque o registro de IP permanece ativo.
• Use GET /banlist com ip para verificar o resultado.