GET /progression/{player_identifier}

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

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

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

Цель

Считывает значения прогресса игрока, такие как опыт, состояние, связанное с уровнем, общее количество реликвий и общее количество технологических очков.

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

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

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

Нет.

Тело запроса

Нет тела запроса.

Схема ответа

200 response schema

Field	Type	Description
Meta	object	Target player metadata.
Progression	object	Progression, currency, defeat, capture, and activity data.

Meta object schema:

Field	Type	Description
PlayerUID	string	Player UID used by Palworld save data.
Player	string	Player identifier supplied in the request path.

Progression object schema:

Field	Type	Description
Player	object	Player level, EXP, and unused status points.
Currencies	object	Relic and technology point totals.
Bosses	object	Boss defeat counters and flags.
Captures	object	Pal capture and butcher counters.
Activities	object	Crafting, dungeon, fishing, treasure, and other activity counters.

Progression.Player object schema:

Field	Type	Description
level	integer	Current player level.
exp	integer	Current EXP value.
unusedStatusPoints	integer	Unused player status points.

Progression.Currencies object schema:

Field	Type	Description
relics	object	Relic point totals keyed by relic type.
technologyPoints	integer	Technology point total.
ancientTechnologyPoints	integer	Ancient technology point total.

Progression.Bosses object schema:

Field	Type	Description
towerBossDefeatCounts	object	Tower boss defeat counts keyed by boss ID.
normalBossDefeatFlags	object	Normal boss defeat flags keyed by boss ID.
raidBossDefeatCounts	object	Raid boss defeat counts keyed by boss ID.
totalBossDefeatCount	integer	Sum of tower boss defeat counts.
predatorDefeatCount	integer	Predator defeat count.

Progression.Captures object schema:

Field	Type	Description
tribeCaptureCount	integer	Total tribe capture count.
palCaptureCounts	object	Pal capture counts keyed by Pal ID.
palCaptureBonusCounts	object	Pal capture bonus counts keyed by Pal ID.
palButcherCounts	object	Pal butcher counts keyed by Pal ID.

Progression.Activities object schema:

Field	Type	Description
craftItemCounts	object	Crafted item counts keyed by item ID.
normalDungeonClearCount	integer	Normal dungeon clear count.
fixedDungeonClearCount	integer	Fixed dungeon clear count.
oilrigClearCount	integer	Oil rig clear count.
palRankUpCounts	object	Pal rank-up counts keyed by Pal ID.
arenaSoloClearCounts	object	Arena solo clear counts keyed by arena ID.
npcTalkCounts	object	NPC talk counts keyed by NPC ID.
fishingCounts	object	Fishing counts keyed by fish ID.
foundTreasureCount	integer	Found treasure count.
campConqueredCount	integer	Camp conquered count.
firstFishingComplete	boolean	Whether first fishing completion is recorded.

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

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

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

HTTP	Код ошибки	Когда это произойдет
401	INVALID_TOKEN	Заголовок Authorization отсутствует, имеет неправильный формат или не соответствует настроенному токену носителя.
403	MISSING_PERMISSION	Токен действителен, но не включает это разрешение конечной точки.
400	INVALID_JSON	Текст запроса был предоставлен, но его не удалось проанализировать как JSON.
400	REQUEST_FAILED	Не удалось определить целевого игрока, учетную запись, данные отдельных персонажей, данные записи или технологические данные.
500	REQUEST_TIMEOUT	Обратный вызов внутреннего игрового потока не завершился в течение 5 секунд.

Примеры

Читать прогресс по идентификатору пользователя PS5

GET /v1/pdapi/progression/ps5_c481a77e22004b9d

Чтение прогресса по PlayerUID

GET /v1/pdapi/progression/92b8f6ac-1a3d-4a9e-8f52-cc741db8c20a

Сценарии

• Подтвердите текущие значения, прежде чем предоставлять прогресс.
• Проверьте действие поддержки после POST /give/progression.
• Создайте панель обзора игроков на доверенной панели администратора.