POST /unban/{user_id}
Punkt końcowy: POST /v1/pdapi/unban/<user_id>
Uwierzytelnianie: token Bearer
Wymagane uprawnienie: REST.Punishments.Unban
Przeznaczenie
Cofa blokadę identyfikatora użytkownika w Banlist.json.
Parametry ścieżki
user_id: Identyfikator użytkownika, którego blokadę należy cofnąć.
Parametry zapytania
Brak.
Treść żądania
Opcjonalne pole tekstowe JSON: Reason.
Schemat odpowiedzi
Schemat odpowiedzi 200
| Pole | Typ | Opis |
|---|---|---|
Success |
wartość logiczna | true, gdy cofnięto aktywną blokadę użytkownika. |
UserId |
ciąg znaków | Identyfikator użytkownika, którego blokadę cofnięto. |
Odpowiedzi błędów
Treść odpowiedzi błędu ma następującą postać:
| HTTP | Kod błędu | Kiedy występuje |
|---|---|---|
401 |
INVALID_TOKEN |
Brakuje nagłówka Authorization, ma on nieprawidłowy format lub nie odpowiada żadnemu skonfigurowanemu tokenowi Bearer. |
403 |
MISSING_PERMISSION |
Token jest prawidłowy, ale nie ma uprawnienia wymaganego przez ten punkt końcowy. |
400 |
INVALID_JSON |
Przesłano treść żądania, ale nie można jej odczytać jako JSON. |
400 |
REQUEST_FAILED |
Funkcja wywołana w wątku gry zgłosiła wyjątek lub wspólny mechanizm wyszukiwania gracza/zasobu zakończył się niepowodzeniem. |
500 |
REQUEST_TIMEOUT |
Wewnętrzna funkcja wywołana w wątku gry nie zakończyła się w ciągu 5 sekund. |
400 |
VALIDATION_FAILED |
Opcjonalne pole żądania ma nieprawidłowy typ JSON. |
404 |
BAN_NOT_FOUND |
Podany user_id nie ma aktywnej blokady. |
Przykłady
Cofnięcie blokady użytkownika Steam
Cofnięcie blokady użytkownika PS5 z domyślnym powodem
Przykładowe zastosowania
- Cofnięcie blokady użytkownika po uwzględnieniu odwołania.
- Zapisz powód na potrzeby późniejszej kontroli.
- Użyj GET /banlist z
userIdlubq, aby sprawdzić wynik.