> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET (/users/xuid({xuid})/history/titles)

> GET (/users/xuid({xuid})/history/titles)

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

* [URI 参数](#ID4EY)
* [查询字符串参数](#ID4EDB)
* [授权](#ID4EFD)
* [可选的请求标头](#ID4EGE)
* [请求正文](#ID4ERF)

## URI 参数

| 参数 | 类型 | 说明 |
| - | - | - |
| xuid | 64 位无符号整数 | 正在访问其标题历史记录的用户的 XBOX User ID (XUID)。 |

## 查询字符串参数

\| 参数 | 是否必需 | 类型 | 说明 |
\| --- | --- | --- | --- | --- | --- | --- |
\| 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({xuid})/history/titles](https://docs.xbox.com/zh-CN/reference/live/rest/uri/titlehistory/uri-titlehistoryusersxuidhistorytitlesv2.md)

### 参考资料

[UserTitle (JSON)](https://docs.xbox.com/zh-CN/reference/live/rest/json/json-usertitlev2.md)

[PagingInfo (JSON)](https://docs.xbox.com/zh-CN/reference/live/rest/json/json-paginginfo.md)

[分页参数](https://docs.xbox.com/zh-CN/reference/live/rest/additional/pagingparameters.md)


## Related topics

- [/users/xuid({xuid})/history/titles](https://docs.xbox.com/zh-CN/reference/live/rest/uri/titlehistory/uri-titlehistoryusersxuidhistorytitlesv2.md)
- [GET (/users/xuid({xuid}))](https://docs.xbox.com/zh-CN/reference/live/rest/uri/presence/uri-usersxuidget.md)
- [GET (/users/xuid({xuid})/groups/{moniker} )](https://docs.xbox.com/zh-CN/reference/live/rest/uri/presence/uri-usersxuidgroupsmonikerget.md)
- [GET (/users/xuid({xuid})/achievements)](https://docs.xbox.com/zh-CN/reference/live/rest/uri/achievements/uri-achievementsusersxuidachievementsgetv2.md)
- [GET (/users/xuid({xuid})/inbox)](https://docs.xbox.com/zh-CN/reference/live/rest/uri/users/uri-usersxuidinboxget.md)