Skip to main content

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

取得使用者已解除鎖定其成就或在其成就上有所進展的遊戲清單。此 API 不會傳回使用者已遊玩或啟動之遊戲的完整歷程記錄。 這些 URI 的網域為 achievements.xboxlive.com。

​
URI 參數

​
查詢字串參數

| 參數| 必要| 類型| 描述| | --- | --- | --- | --- | --- | --- | --- | | skipItems| 否| 32 位元帶正負號的整數| 傳回從指定項目數目之後開始的項目。例如，skipItems=“3” 會從擷取到的第四個項目開始擷取項目。 | | continuationToken| 否| string| 傳回從指定接續權杖開始的項目。 | | maxItems| 否| 32 位元帶正負號的整數| 要從集合傳回的項目數目上限，可與 skipItems 和 continuationToken 合併使用以傳回某個範圍的項目。如果沒有 maxItems，服務可能會提供預設值，且即使尚未傳回最後一頁的結果，也可能傳回少於 maxItems 的項目。 |

​
授權

| 宣告| 必要?| 描述| 遺漏時的行為| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 使用者| 呼叫者是經過授權的 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) 分頁參數
Last modified on October 6, 2026