POST /give/pals/{player_identifier}
Punkt końcowy: POST /v1/pdapi/give/pals/<player_identifier>
Uwierzytelnianie: token Bearer
Wymagane uprawnienie: REST.Pals.Give
Przeznaczenie
Przyznaje jednego lub kilka Pali według identyfikatora i poziomu.
Parametry ścieżki
player_identifier:UserIdlubPlayerUIDdocelowego gracza.
Parametry zapytania
Brak.
Treść żądania
Obiekt JSON z tablicą przyznawanych Pali Pals. Każdy wpis wymaga PalID i dodatniego Level.
Schemat odpowiedzi
Schemat odpowiedzi 200
| Pole | Typ | Opis |
|---|---|---|
Granted |
obiekt | Liczby nagród przyznanych przez żądanie. |
Granted — schemat obiektu:
| Pole | Typ | Opis |
|---|---|---|
Pals |
liczba całkowita | Liczba przyznanych Pali. |
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 |
Treść nie zawiera tablicy Pals. |
400 |
VALIDATION_FAILED |
Co najmniej jeden wpis Pala jest nieprawidłowy lub gracz nie ma wystarczająco dużo miejsca na Pale. |
Przykłady
Przyznanie startowego Pala graczowi GDK
Przyznanie Pali z wydarzenia według PlayerUID
Przykładowe zastosowania
- Przyznawanie prostych nagród w postaci Pali bez utrzymywania pliku szablonu.
- Skrypty losowych nagród zmieniające tylko
PalIDiLevel. - Żądanie może się nie powieść, jeśli nie znaleziono gracza,
PalIDjest błędne lub brakuje miejsca na Pale.