POST /forgettech/{player_identifier}
Punkt końcowy: POST /v1/pdapi/forgettech/<player_identifier>
Uwierzytelnianie: token Bearer
Wymagane uprawnienie: REST.Techs.Forget
Przeznaczenie
Usuwa jedną, kilka lub wszystkie poznane technologie gracza.
Parametry ścieżki
player_identifier:UserIdlubPlayerUIDdocelowego gracza.
Parametry zapytania
Brak.
Treść żądania
Technology może być pojedynczym TechID, ciągiem znaków "All" lub tablicą ciągów TechID. Nie umieszczaj "All" w tablicy.
Schemat odpowiedzi
Schemat odpowiedzi 200
| Pole | Typ | Opis |
|---|---|---|
ForgottenCount |
liczba całkowita | Liczba technologii usuniętych graczowi. |
Forgotten |
tablica ciągów znaków lub ciąg znaków | Identyfikatory usuniętych technologii lub All, gdy usunięto wszystkie odblokowane technologie. |
Skipped |
tablica ciągów znaków | Identyfikatory technologii pominiętych, ponieważ nie były odblokowane. |
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 |
INVALID_REQUEST |
Brakuje Technology lub nie jest ono ciągiem znaków ani tablicą w oczekiwanym formacie. |
400 |
VALIDATION_FAILED |
Tablica Technology zawiera wartość inną niż ciąg znaków, All lub nieprawidłowy identyfikator technologii. |
Przykłady
Usunięcie jednej technologii gracza GDK
Usunięcie kilku technologii według PlayerUID
Usunięcie wszystkich technologii gracza Steam
Przykładowe zastosowania
- Usunięcie technologii przyznanej przez pomyłkę.
- Zresetowanie konta testowego za pomocą
"All". - Sprawdź stan przed żądaniem i po nim za pomocą GET /techs.