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

# POST (/users/xuid({xuid})/achievements/{scid}/update)

> POST (/users/xuid({xuid})/achievements/{scid}/update)

# POST (/users/xuid({xuid})/achievements/{scid}/update)

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

* [URI 參數](#ID4EV)
* [授權](#ID4EAB)
* [必要的要求標頭](#ID4EPG)
* [選用的要求標頭](#ID4EPH)
* [要求本文](#ID4ECBAC)
* [HTTP 狀態碼](#ID4ENBAC)
* [回應本文](#ID4EBGAC)

## 備註

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

<a id="ID4EV" />

## URI 參數

| 參數 | 類型 | 描述 |
| - | - | - |
| xuid | 64 位元不帶正負號整數 | 要存取其資源之使用者的 XBOX 使用者識別碼 (XUID)。必須與已驗證使用者的 XUID 相符。 |
| scid | GUID | 要存取其成就之服務設定的唯一識別碼。 |

<a id="ID4EAB" />

## 授權

| 宣告 | 必要? | 描述 | 遺漏時的行為 |
| - | - | - | - |
| User | 是 | 提出要求之 XBOX LIVE 上的有效使用者。 | 403 Forbidden |

<a id="ID4EPG" />

## 必要的要求標頭

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

<a id="ID4EPH" />

## 選用的要求標頭

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

<a id="ID4ECBAC" />

## 要求本文

[AchievementUpdateRequest (JSON)](/zh-TW/reference/live/rest/json/json-achievementupdaterequest) 物件。

<a id="ID4EPB" />

### 範例要求

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

```json theme={null}
{
    "action": "progressUpdate",
    "serviceConfigId": "00000000-0000-0000-0000-000000000000",
    "titleId": 0000000000,
    "userId": "2810000000000000",
    "achievements": [
        {
            "id": "1",
            "percentComplete": 100
        }
    ]
}
```

<a id="ID4ENBAC" />

## HTTP 狀態碼

服務會傳回本節中的其中一個狀態碼，以回應在此資源上使用此方法所提出的要求。如需搭配 XBOX Live 服務使用的標準 HTTP 狀態碼完整清單，請參閱[標準 HTTP 狀態碼](/zh-TW/reference/live/rest/additional/httpstatuscodes)。

\| 代碼| 原因片語| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 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| 要求的資源已不再可用。|

<a id="ID4EBGAC" />

## 回應本文

回應本文是空的。

## 另請參閱

##### 上層

[/users/xuid({xuid})/achievements/{scid}/update](/zh-TW/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidupdate)


## Related topics

- [XblAchievementsUpdateAchievementAsync](/zh-TW/reference/live/xsapi-c/achievements_c/functions/xblachievementsupdateachievementasync.md)
- [XblAchievementsManagerUpdateAchievement](/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)