POST /give/paleggs/{player_identifier}

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

Uwierzytelnianie: token Bearer

Wymagane uprawnienie: REST.PalEggs.Give

Przeznaczenie

Daje wskazanemu graczowi jedno lub kilka jaj Pali.

Parametry ścieżki

player_identifier: UserId lub PlayerUID docelowego gracza.

Parametry zapytania

Brak.

Treść żądania

Obiekt JSON z tablicą przyznawanych jaj PalEggs. EggID jest identyfikatorem ItemID. Każde jajo musi używać albo PalID, albo PalTemplate, nigdy obu naraz.

Schemat odpowiedzi

Schemat odpowiedzi 200

Pole	Typ	Opis
`Granted`	obiekt	Liczby nagród przyznanych przez żądanie.

Granted — schemat obiektu:

Pole	Typ	Opis
`PalEggs`	liczba całkowita	Liczba przyznanych jaj 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 `PalEggs`.
`400`	`VALIDATION_FAILED`	Co najmniej jeden wpis jaja jest nieprawidłowy, nie może zostać zaimportowany lub nie mieści się w ekwipunku.

Przykłady

Przyznanie graczowi Steam jaja z określonym poziomem

POST /v1/pdapi/give/paleggs/steam_76561198012345678

{
    "PalEggs": [
        { "EggID": "PalEgg_Fire_01", "PalID": "Foxparks", "Level": 12 }
    ]
}

Przyznanie jaja z szablonu według PlayerUID

POST /v1/pdapi/give/paleggs/6d2e8b40-73ef-4f11-9bb8-2e91a36e2f09

{
    "PalEggs": [
        { "EggID": "PalEgg_Dark_01", "PalTemplate": "dark_event_reward.json" }
    ]
}

Przykładowe zastosowania

Przyznawanie jaj podczas wydarzeń bez natychmiastowego tworzenia Pala.
Używaj PalID dla prostych jaj, a PalTemplate dla jaj z niestandardową zawartością.
Żądanie może się nie powieść, jeśli ItemID jaja jest błędne lub brakuje miejsca w ekwipunku gracza.