Skip to main content

GET (/users/xuid()/achievements//)

取得成就的詳細資料。 這些 URI 的網域為 achievements.xboxlive.com。

URI 參數

授權

使用的授權宣告 | 宣告| 必要?| 描述| 遺漏時的行為| | --- | --- | --- | --- | --- | --- | --- | | User| 是| 提出要求之 XBOX LIVE 上的有效使用者。| 403 Forbidden| | Title| 否| 呼叫的遊戲。| 取決於 AuthZ。自 2013 年 5 月 1 日起,AuthZ 在遺漏時不會提供宣告,因此將拒絕存取任何未標示為公開的 SCID。| | Sandbox| 否| 應從中擷取結果的沙箱。| 取決於 AuthZ。自 2013 年 5 月 1 日起,AuthZ 在遺漏時不會提供預設宣告。|

隱私權設定對資源的影響

隱私權設定對資源的影響 | 要求的使用者| 目標使用者的隱私權設定| 行為| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | me| -| 如所述。| | 朋友| 所有人| OK| | 朋友| 僅限朋友| OK| | 朋友| 已封鎖| 禁止。| | 非朋友使用者| 所有人| OK| | 非朋友使用者| 僅限朋友| 禁止。| | 非朋友使用者| 已封鎖| 禁止。| | 協力廠商網站| 所有人| OK| | 協力廠商網站| 僅限朋友| 禁止。| | 協力廠商網站| 已封鎖| 禁止。|

必要的要求標頭

| 標頭| 類型| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| HTTP 驗證的驗證認證。範例值:“XBL3.0 x=<userhash>;<token>”。|

選用的要求標頭

| 標頭| 類型| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| string| 此要求應導向之 XBOX LIVE 服務的組建名稱/編號。只有在驗證標頭的有效性、驗證權杖中的宣告等之後,要求才會路由至該服務。預設值:1。| | x-xbl-contract-version| string| 預設為 V1。| | Accept-Language| string| 所需地區設定及後援的清單 (例如 fr-FR、fr、en-GB、en-WW、en-US)。成就服務會依序檢查清單,直到找到相符的當地語系化字串為止。如果找不到,則會嘗試比對使用者權杖中定義的位置,該位置來自使用者的 IP 位址。如果仍然找不到相符的當地語系化字串,則會使用遊戲開發人員/發行者提供的預設字串。 |

要求本文

此要求的本文中不會傳送任何物件。 

HTTP 狀態碼

服務會傳回本節中的其中一個狀態碼,以回應在此資源上使用此方法所提出的要求。如需搭配 XBOX Live 服務使用的標準 HTTP 狀態碼完整清單,請參閱標準 HTTP 狀態碼。 | 代碼| 原因片語| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| 已成功擷取工作階段。| | 301| Moved Permanently| 服務已移至不同的 URI。| | 307| Temporary Redirect| 此資源的 URI 已暫時變更。| | 400| Bad Request| 服務無法理解格式錯誤的要求。通常是無效的參數。| | 401| Unauthorized| 要求需要使用者驗證。| | 403| Forbidden| 不允許使用者或服務提出此要求。| | 404| Not Found| 找不到指定的資源。| | 406| Not Acceptable| 不支援資源版本;應由 MVC 層拒絕。| | 408| Request Timeout| 要求花費太長的時間才能完成。| | 410| Gone| 要求的資源已不再可用。|

回應本文

範例回應

另請參閱

上層
/users/xuid()/achievements//
Last modified on October 6, 2026