POST /give/progression/{player_identifier}

Конечная точка: POST /v1/pdapi/give/progression/<player_identifier>

Аутентификация: Токен носителя

Разрешение: REST.Progression.Give

Цель

Предоставляет игроку значения прогресса.

Параметры пути

• player_identifier: UserId или PlayerUID для целевого игрока.

Параметры запроса

Нет.

Тело запроса

JSON object с хотя бы одним поддерживаемым разрешением: положительный integer EXP, положительный integer TechnologyPoints, положительный integer AncientTechnologyPoints или Relics как непустой object с ключом по типу реликвии с положительные суммы integer.

Поддерживаемые типы реликвий: CapturePower, HungerReduction, SwimSpeed, FoodDecayReduction, JumpPower, GliderSpeed, ClimbSpeed, StatusAilmentResist, StaminaReduction, SphereHoming, ExpBonus, RainbowPassiveRate, MoveSpeed.

Схема ответа

200 response schema

Field	Type	Description
Granted	object	Progression values granted by the request.
Totals	object	Updated totals for granted currencies, when applicable.

Granted object schema:

Field	Type	Description
EXP	integer	EXP granted, when requested.
Relics	object	Relic point amounts granted by relic type, when requested.
TechnologyPoints	integer	Technology points granted, when requested.
AncientTechnologyPoints	integer	Ancient technology points granted, when requested.

Totals object schema:

Field	Type	Description
Relics	object	Updated relic point totals by relic type, when Relics was granted.
TechnologyPoints	integer	Updated technology point total, when TechnologyPoints was granted.
AncientTechnologyPoints	integer	Updated ancient technology point total, when AncientTechnologyPoints was granted.

Реакции на ошибки

Тела ошибок используют следующую форму:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "Human-readable message",
        "Details": {}
    }
}

HTTP	Код ошибки	Когда это произойдет
401	INVALID_TOKEN	Заголовок Authorization отсутствует, имеет неправильный формат или не соответствует настроенному токену носителя.
403	MISSING_PERMISSION	Токен действителен, но не включает это разрешение конечной точки.
400	INVALID_JSON	Текст запроса был предоставлен, но его не удалось проанализировать как JSON.
400	REQUEST_FAILED	Обратный вызов игрового потока вызвал исключение, или произошел сбой общего преобразователя player/resource.
500	REQUEST_TIMEOUT	Обратный вызов внутреннего игрового потока не завершился в течение 5 секунд.
400	INVALID_REQUEST	Тело не содержит EXP, Relics, TechnologyPoints или AncientTechnologyPoints.
400	VALIDATION_FAILED	Указанное значение прогресса отсутствует, не integer, неположительное или необходимые внутренние элементы прогресса недоступны.

Примеры

Дайте EXP игроку GDK

POST /v1/pdapi/give/progression/gdk_2533274898765432

{
    "EXP": 25000
}

Выдавайте очки и реликвии по PlayerUID

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

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

Сценарии

• Компенсация игрокам после отката сохранения.
• Добавляйте технологические очки, не открывая конкретную технологию.
• Вместо этого используйте POST /learntech, если вы хотите разблокировать определенный TechID.