最近发布的玩家
追加或更新用户的最近玩家列表（单向）。
此 API 允许游戏客户端追加到用户的最近玩家列表，并更新现有的最近玩家条目。 此调用仅影响调用方的最近玩家列表（单向）。
POST /titles/{titleId}/recentplayers
URI 参数
| 参数 |
In |
必需 |
类型 |
说明 |
| titleId |
路径 |
TRUE |
integer |
要为其发送请求的游戏的 titleId。 |
| 名称 |
必需 |
类型 |
说明 |
| 授权 |
TRUE |
integer |
调用方必须提供采用 XBL 3.0 授权格式的 XToken。 例如，授权: XBL3.0 x=2553948354698;>加密令牌<) |
| Content-Type |
TRUE |
字符串 |
ContentType 必须设置为 application/json |
请求正文
| 名称 |
必需 |
类型 |
说明 |
| recentPlayers |
TRUE |
|
此用户的最近玩家数组。 应至少有 1 名和最多 100 名最近玩家。 |
响应
| 名称 |
类型 |
说明 |
| 204 无内容 |
|
已成功发送最近玩家请求。 |
| 400 错误请求 |
ErrorResponse |
处理请求时出错... 可能的错误代码：“RequestValidationError：请求验证失败。”、“AuthorizationError：不允许调用方访问资源。” |
| 其他状态代码 |
ThrottledEntity |
请求过多。 标头重试-之后：整数 |
定义
ClientRecentPlayersRequest
| 名称 |
类型 |
说明 |
| recentPlayers |
|
此用户的最近玩家数组。 应至少有 1 名和最多 100 名最近玩家。 |
EncounterType
最近玩家遇到的类型。 此字段是可选的，并默认为默认值。 默认值没有规定的含义 - 由调用方适当解释此值。
| 名称 |
类型 |
说明 |
| 默认值 |
字符串 |
|
| Opponent |
字符串 |
|
| 队友。 |
字符串 |
|
ErrorResponse
| 名称 |
类型 |
说明 |
| debugMessage |
字符串 |
可用于调试的错误消息的人工可读版本。 |
| errorCode |
字符串 |
错误代码枚举。 |
网络
ThrottledEntity
| 名称 |
类型 |
说明 |
| currentRequests |
字符串 |
当前请求数 - 并发或速率。 |
| debugMessage |
字符串 |
可用于调试的限制消息的人工可读版本。 |
| LimitType |
字符串 |
限制类型，即并发或速率。 |
| maxRequests |
字符串 |
允许的最大请求数 - 并发或速率。 |
| periodInSeconds |
字符串 |
超出速率或并发限制时适用的时段（以秒为单位）。 |
| 版本 |
字符串 |
当前限制协定版本。 |