发布服务器最近玩家

追加或更新一组用户的最近玩家列表（单向）。 这实质上是用于服务器的客户端 API 的批处理 API。

此 API 允许游戏服务器追加到一组用户的最近玩家列表，并更新现有的最近玩家条目。 每个用户的最近玩家列表都是单向的。

POST /titles/{titleId}/recentplayers/server

URI 参数

参数	In	必需	类型	说明
titleId	路径	TRUE	integer	要为其发送请求的游戏的 titleId。

请求头文件

名称	必需	类型	说明
授权	TRUE	integer	调用方必须提供采用 XBL 3.0 授权格式的 XToken。 例如，授权: XBL3.0 x=2553948354698;>加密令牌<)
Content-Type	TRUE	字符串	ContentType 必须设置为 application/json

请求正文

名称	必需	类型	说明
recentPlayersByXuid	TRUE	ServerRecentPlayersByXuid[]	表示 XUID 及其最近玩家的对象数组。 XUID 条目应至少为 1 个和最多 20 个。

响应

名称	类型	说明
204 无内容		已成功发送最近玩家请求。
400 错误请求	ErrorResponse	处理请求时出错... 可能的错误代码：“RequestValidationError：请求验证失败。”、“AuthorizationError：不允许调用方访问资源。”
其他状态代码	ThrottledEntity	请求过多。 标头重试-之后：整数

定义

• EncounterType
• ErrorResponse
• 网络
• ServerRecentPlayersByXuid
• ServerRecentPlayersRequest
• ThrottledEntity
• UnidirectionalRecentPlayer

EncounterType

最近玩家遇到的类型。 此字段是可选的，并默认为默认值。 默认值没有规定的含义 - 由调用方适当解释此值。

名称	类型	说明
默认值	字符串
Opponent	字符串
队友。	字符串

ErrorResponse

名称	类型	说明
debugMessage	字符串	可用于调试的错误消息的人工可读版本。
errorCode	字符串	错误代码枚举。

网络

名称	类型	说明
XboxLive	字符串

ServerRecentPlayersByXuid

名称	类型	说明
recentPlayers	UnidirectionalRecentPlayer[]	此用户的最近玩家数组。 应至少有 1 名和最多 100 名最近玩家。
xuid	字符串	用户的 XUID（基 10 整数）。

ServerRecentPlayersRequest

名称	类型	说明
recentPlayersByXuid	ServerRecentPlayersByXuid[]	表示 XUID 及其最近玩家的对象数组。 XUID 条目应至少为 1 个和最多 20 个。

ThrottledEntity

名称	类型	说明
currentRequests	字符串	当前请求数 - 并发或速率。
debugMessage	字符串	可用于调试的限制消息的人工可读版本。
LimitType	字符串	限制类型，即并发或速率。
maxRequests	字符串	允许的最大请求数 - 并发或速率。
periodInSeconds	字符串	超出速率或并发限制时适用的时段（以秒为单位）。
版本	字符串	当前限制协定版本。

UnidirectionalRecentPlayer

名称	类型	说明
encounterType	EncounterType	最近玩家遇到的类型。 此字段是可选的，并默认为默认值。 默认值没有规定的含义 - 由调用方适当解释此值。
ID	字符串	另一个用户的 ID（XUID 基 10 整数）。
网络	网络	在其上遇到其他用户的网络。
timestamp	字符串