跳转至

GET /pals/{player_identifier}

端点: GET /v1/pdapi/pals/<player_identifier>

认证: Bearer 令牌

权限: REST.Pals.Read

用途

列出目标玩家的帕鲁。响应中的帕鲁标识可在 paldeck.cc/pals 查询。

路径参数

  • player_identifier: 目标玩家的 UserId 或 PlayerUID。

查询参数

无。

请求体

无请求体。

响应结构

200 响应架构

字段 类型 描述
Meta object 目标玩家元数据及帕鲁数量。
Pals object 目标玩家的队伍、帕鲁终端和基地帕鲁。

Meta 对象架构：

字段 类型 描述
PlayerUID string Palworld 存档数据使用的玩家 UID。
Player string 请求路径中提供的玩家标识符。
TeamCount integer 玩家队伍中的帕鲁数量。
PalboxCount integer 玩家帕鲁终端中的帕鲁数量。
BaseCampCount integer 包含的基地数量。

Pals 对象架构：

字段 类型 描述
Team object 以帕鲁实例 ID 为键的队伍帕鲁。
Palbox object 以帕鲁实例 ID 为键的帕鲁终端帕鲁。
BaseCamps object[] 公会基地及其分配的工作帕鲁。

帕鲁对象架构：

字段 类型 描述
PalID string 帕鲁种类标识符。
UniqueNPCID string 唯一 NPC ID（如果存在）。
Nickname string 自定义帕鲁昵称；没有时为空字符串。
SkinId string 皮肤 ID；没有时为空字符串。
Gender string 帕鲁性别。
Level integer 帕鲁等级。
Exp integer 帕鲁经验值。
Shiny boolean 是否为稀有帕鲁。
PartnerSkillLevel integer 伙伴技能等级。
CondensedPals integer 浓缩等级进度。
UnusedStatusPoints integer 帕鲁未使用的属性点。
FriendshipPoints integer 亲密度点数。
PhysicalHealth string 身体健康状态。
WorkerSick string 工作帕鲁的疾病状态。
ImportedCharacter boolean 是否标记为已导入。
HP number 当前生命值。
MP number 当前魔力值（如果存在）。
SP number 当前耐力值（如果存在）。
Shield number 当前护盾值（如果存在）。
Hunger number 当前饥饿值。
MaxHunger number 最大饥饿值。
SAN number 理智值。
Support integer 支援值。
CraftSpeed integer 制作速度值。
PalSouls object 包含 Health、Attack、Defense 和 CraftSpeed 的帕鲁灵魂等级。
IVs object 包含 Health、AttackMelee、AttackShot 和 Defense 的个体值。
ActiveSkills string[] 已装备的主动技能。
LearntSkills string[] 已学会的技能。
Passives string[] 被动技能 ID。
ExtraWorkSuitabilities object 以适应性 ID 为键的额外工作适应性等级。
DisableWorkPreferences string[] 已禁用的工作偏好 ID。
team_slot_index integer 队伍栏位索引，仅存在于 Team 帕鲁。
page integer 帕鲁终端页面索引，仅存在于 Palbox 帕鲁。
slot integer 帕鲁终端栏位索引，仅存在于 Palbox 帕鲁。
base_camp_slot_index integer 基地工作帕鲁栏位索引，仅存在于基地帕鲁。

BaseCamps[] 条目架构：

字段 类型 描述
id string 基地 GUID。
level integer 基地等级。
world_pos object 基地世界坐标。
map_pos object 转换后的地图坐标。
state string 当前基地状态。
pals object 以帕鲁实例 ID 为键的基地工作帕鲁。

坐标对象架构：

字段 类型 描述
x number X 坐标。
y number Y 坐标。
z number Z 坐标。

错误响应

错误响应使用以下格式:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "人类可读的消息",
        "Details": {}
    }
}
HTTP 错误代码 发生条件
401 INVALID_TOKEN Authorization 头缺失、格式错误，或与配置的 Bearer 令牌不匹配。
403 MISSING_PERMISSION 令牌有效，但不包含此端点权限。
400 INVALID_JSON 提供了请求体，但无法解析为 JSON。
400 REQUEST_FAILED 游戏线程回调抛出异常，或共享玩家/资源解析器失败。
500 REQUEST_TIMEOUT 内部游戏线程回调未在 5 秒内完成。
404 PLAYER_NOT_FOUND 没有在线玩家与提供的 player_identifier 匹配。
404 PLAYER_STATE_NOT_FOUND 玩家存在，但其 APalPlayerState 不可用。

示例

读取 PS5 玩家的帕鲁

GET /v1/pdapi/pals/ps5_0f4b8c2d91aa34ef

按 PlayerUID 读取帕鲁

GET /v1/pdapi/pals/6d2e8b40-73ef-4f11-9bb8-2e91a36e2f09

使用场景