GET /player/{player_identifier}

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

认证: Bearer 令牌

权限: REST.Player.Read

用途

返回一个玩家。标识符可以是支持的玩家标识，例如 UserId 或 PlayerUID。

无。

无请求体。

Field	Type	Description
`Player`	object	Player details.

Player object schema:

Field	Type	Description
`Name`	string	Current or saved player name.
`IP`	string	Player IP address, or an empty string when unavailable.
`PlayerUID`	string	Player UID used by Palworld save data.
`UserId`	string	Platform user ID, or an empty string when unavailable.
`GuildName`	string	Guild name, or an empty string when unavailable.
`GuildUUID`	string	Guild UUID, or a zero GUID when unavailable.
`Status`	string	Saved player account state.
`WorldLocation`	object	Current or last saved world coordinates.
`MapLocation`	object	Converted map coordinates.

Location object schema:

错误响应使用以下格式:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "人类可读的消息",
        "详情": {}
    }
}

HTTP	错误代码	发生条件
`401`	`INVALID_TOKEN`	`Authorization` 头缺失、格式错误，或与配置的 Bearer 令牌不匹配。
`403`	`MISSING_PERMISSION`	令牌有效，但不包含此端点权限。
`400`	`INVALID_JSON`	提供了请求体，但无法解析为 JSON。
`400`	`REQUEST_FAILED`	游戏线程回调抛出异常，或共享玩家/资源解析器失败。
`500`	`REQUEST_TIMEOUT`	内部游戏线程回调未在 5 秒内完成。
`404`	`PLAYER_NOT_FOUND`	No online player matched the supplied `player_identifier`.
`404`	`PLAYER_ACCOUNT_NOT_FOUND`	已找到玩家，但无法加载玩家账号数据。

GET /v1/pdapi/player/steam_76561198012345678

GET /v1/pdapi/player/b7f4e91a-2c53-4d8f-a6e1-93c4bb62a7d1