Przejdź do treści

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: UserId lub PlayerUID docelowego 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ć:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "Czytelny opis błędu",
        "Details": {}
    }
}
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

POST /v1/pdapi/give/pals/gdk_2533274812345678
{
    "Pals": [
        { "PalID": "Pengullet", "Level": 10 }
    ]
}

Przyznanie Pali z wydarzenia według PlayerUID

POST /v1/pdapi/give/pals/b7f4e91a-2c53-4d8f-a6e1-93c4bb62a7d1
{
    "Pals": [
        { "PalID": "Anubis", "Level": 35 },
        { "PalID": "Kitsun", "Level": 25 }
    ]
}

Przykładowe zastosowania

  • Przyznawanie prostych nagród w postaci Pali bez utrzymywania pliku szablonu.
  • Skrypty losowych nagród zmieniające tylko PalID i Level.
  • Żądanie może się nie powieść, jeśli nie znaleziono gracza, PalID jest błędne lub brakuje miejsca na Pale.