POST /give/progression/{player_identifier}

Punkt końcowy: POST /v1/pdapi/give/progression/<player_identifier>

Uwierzytelnianie: token Bearer

Wymagane uprawnienie: REST.Progression.Give

Przeznaczenie

Przyznaje graczowi postępy.

Parametry ścieżki

• player_identifier: UserId lub PlayerUID docelowego gracza.

Parametry zapytania

Brak.

Treść żądania

Obiekt JSON z co najmniej jedną obsługiwaną nagrodą: dodatnią liczbą całkowitą EXP, TechnologyPoints lub AncientTechnologyPoints, albo niepustym obiektem Relics, którego klucze oznaczają typy reliktów, a wartości są dodatnimi liczbami całkowitymi.

Obsługiwane typy reliktów: CapturePower, HungerReduction, SwimSpeed, FoodDecayReduction, JumpPower, GliderSpeed, ClimbSpeed, StatusAilmentResist, StaminaReduction, SphereHoming, ExpBonus, RainbowPassiveRate, MoveSpeed.

Schemat odpowiedzi

Schemat odpowiedzi 200

Pole	Typ	Opis
Granted	obiekt	Wartości postępów przyznane przez żądanie.
Totals	obiekt	Zaktualizowane sumy przyznanych walut, jeśli dotyczy.

Granted — schemat obiektu:

Pole	Typ	Opis
EXP	liczba całkowita	Przyznane EXP, jeśli zażądano ich przyznania.
Relics	obiekt	Przyznane punkty reliktów według typu, jeśli zażądano ich przyznania.
TechnologyPoints	liczba całkowita	Przyznane punkty technologii, jeśli zażądano ich przyznania.
AncientTechnologyPoints	liczba całkowita	Przyznane punkty starożytnej technologii, jeśli zażądano ich przyznania.

Totals — schemat obiektu:

Pole	Typ	Opis
Relics	obiekt	Zaktualizowane sumy punktów reliktów według typu, jeśli przyznano Relics.
TechnologyPoints	liczba całkowita	Zaktualizowana suma punktów technologii, jeśli przyznano TechnologyPoints.
AncientTechnologyPoints	liczba całkowita	Zaktualizowana suma punktów starożytnej technologii, jeśli przyznano AncientTechnologyPoints.

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 żadnego z pól EXP, Relics, TechnologyPoints ani AncientTechnologyPoints.
400	VALIDATION_FAILED	Brakuje wymaganej wartości postępów, wartość nie jest dodatnią liczbą całkowitą lub wewnętrzne dane postępów są niedostępne.

Przykłady

Przyznanie EXP graczowi GDK

POST /v1/pdapi/give/progression/gdk_2533274898765432

{
    "EXP": 25000
}

Przyznanie punktów i reliktów według PlayerUID

POST /v1/pdapi/give/progression/f0a1c3e9-7d5b-4a28-8c33-411fdc2e6b74

{
    "Relics": {
        "CapturePower": 5,
        "MoveSpeed": 2
    },
    "TechnologyPoints": 10,
    "AncientTechnologyPoints": 2
}

Przykładowe zastosowania

• Rekompensaty dla graczy po przywróceniu wcześniejszego zapisu.
• Dodawanie punktów technologii bez odblokowania określonej technologii.
• Aby odblokować określone TechID, użyj POST /learntech.