Skip to main content

POST (/users/xuid()/achievements//update)

更新成就的進度。 這些 URI 的網域為 achievements.xboxlive.com。

備註

  • 成功的呼叫會傳回 HTTP 狀態碼 200 和空白的回應本文。
  • 如果呼叫未對成就進度造成任何變更 (亦即成就已解除鎖定,或完成百分比相同),呼叫會傳回 HTTP 狀態碼 304 和空白的回應本文。

URI 參數

授權

必要的要求標頭

| 標頭| 類型| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| HTTP 驗證的驗證認證。範例值:“XBL3.0 x=<userhash>;<token>”。| | x-xbl-contract-version| 2| API 合約版本。|

選用的要求標頭

| 標頭| 類型| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Accept-Language| string| 所需地區設定及後援的清單 (例如 fr-FR、fr、en-GB、en-WW、en-US)。成就服務會依序檢查清單,直到找到相符的當地語系化字串為止。如果找不到,則會嘗試比對使用者權杖中定義的位置,該位置來自使用者的 IP 位址。如果仍然找不到相符的當地語系化字串,則會使用遊戲開發人員/發行者提供的預設字串。 |

要求本文

AchievementUpdateRequest (JSON) 物件。

範例要求

POST /users/xuid({2810000000000000})/achievements/{00000000-0000-0000-0000-000000000000}/update

HTTP 狀態碼

服務會傳回本節中的其中一個狀態碼,以回應在此資源上使用此方法所提出的要求。如需搭配 XBOX Live 服務使用的標準 HTTP 狀態碼完整清單,請參閱標準 HTTP 狀態碼。 | 代碼| 原因片語| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| 已成功擷取工作階段。| | 301| Moved Permanently| 服務已移至不同的 URI。| | 304| Not Modified| 成就進度未修改。| | 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//update
Last modified on October 6, 2026