​

GET (/users/xuid()/history/titles)

获取用户已解锁或已在其成就上取得进度的标题列表。此 API 不会返回用户玩过或启动过的完整标题历史记录。 这些 URI 的域为 achievements.xboxlive.com。

• URI 参数
• 查询字符串参数
• 授权
• 可选的请求标头
• 请求正文

​

URI 参数

​

查询字符串参数

| 参数 | 是否必需 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | --- | | skipItems | 否 | 32 位有符号整数 | 从给定的项数之后开始返回项目。例如,skipItems=“3” 将从检索到的第四项开始检索项目。 | | continuationToken | 否 | string | 从给定的延续标记开始返回项目。 | | maxItems | 否 | 32 位有符号整数 | 从集合中返回的最大项数,可与 skipItems 和 continuationToken 结合使用以返回一定范围的项目。如果没有提供 maxItems,服务可能会提供一个默认值,并且即使尚未返回最后一页结果,返回的项目数量也可能少于 maxItems。 |

​

授权

| 声明 | 是否必需? | 说明 | 缺失时的行为 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | User | 调用方是已授权的 XBOX LIVE 用户。 | 调用方需要是 XBOX LIVE 上的有效用户。 | 403 Forbidden |

​

可选的请求标头

| 标头 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion | string | 此请求应发送到的 XBOX LIVE 服务的生成名称/编号。仅在验证标头的有效性、认证令牌中的声明等之后,请求才会被路由到该服务。 | | x-xbl-contract-version | 32 位无符号整数 | 如果存在且设置为 2,则使用此 API 的 V2 版本。否则使用 V1。 |

​

请求正文

此请求的正文中不发送任何对象。

​

另请参阅

父主题

/users/xuid()/history/titles

参考资料

UserTitle (JSON) PagingInfo (JSON) 分页参数