> ## 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 和空的响应正文。

## URI 参数

| 参数 | 类型 | 说明 |
| - | - | - |
| xuid | 64 位无符号整数 | 正在访问其资源的用户的 XBOX User ID (XUID)。必须与已认证用户的 XUID 匹配。 |
| scid | GUID | 正在访问其成就的服务配置的唯一标识符。 |

## 授权

| 声明 | 是否必需? | 说明 | 缺失时的行为 |
| - | - | - | - |
| User | 是 | 为其发起请求的 XBOX LIVE 上的有效用户。 | 403 Forbidden |

## 必需的请求标头

| 标头 | 类型 | 说明 |
| - | - | - |
| 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)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-achievementupdaterequest) 对象。

### 请求示例

`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
        }
    ]
}
```

## HTTP 状态代码

服务针对使用此方法对此资源发出的请求,返回本节中的某个状态代码。有关与 XBOX Live 服务一同使用的标准 HTTP 状态代码的完整列表,请参见 [标准 HTTP 状态代码](https://devdocs.xbox.com/zh-CN/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 | 请求的资源不再可用。 |

## 响应正文

响应正文为空。

## 另请参阅

##### 父主题

[/users/xuid({xuid})/achievements/{scid}/update](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidupdate)


## Related topics

- [XblAchievementsUpdateAchievementAsync](https://devdocs.xbox.com/fr-CA/reference/live/xsapi-c/achievements_c/functions/xblachievementsupdateachievementasync.md)
- [XblAchievementsManagerUpdateAchievement](https://devdocs.xbox.com/es/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)