通过

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

  • 项目

更新成就的进度。 这些 URI 的域是 achievements.xboxlive.com。

备注

  • 成功的调用将返回具有空响应正文的 HTTP 状态代码 200。
  • 如果调用未导致成就进度更改（即它已解锁或完成百分比相同），则调用将返回包含空响应正文的 HTTP 状态代码 304。

URI 参数

参数 类型 说明
xuid 64 位无符号整数 正在访问其资源的用户的 Xbox 用户 ID (XUID)。 必须与经过身份验证的用户的 XUID 匹配。
scid GUID 正在访问其成就的服务配置的唯一标识符。

授权

声明 必填？ 说明 缺少时的行为
用户 是 正在为其发起请求的 Xbox LIVE 上的有效用户。 403 已禁止

必需请求标头

标头 类型 说明
授权 字符串 HTTP 身份验证的身份验证凭据。 示例值：“XBL3.0 x=<userhash>;<token>”。
x-xbl-contract-version 2 API 协定版本。

可选请求标头

标头 类型 说明
Accept-Language 字符串 所需区域设置和回退（例如，fr-FR、fr、en-GB、en-WW、en-US）的列表。 成就服务将查找整个列表，直到找到匹配的本地化字符串。 如果未找到，它将尝试匹配在用户令牌中定义的位置，此位置来自用户的 IP 地址。 如果仍未找到匹配的本地化字符串，它将使用游戏开发者/发布者提供的默认字符串。

请求正文

AchievementUpdateRequest （JSON） 对象。

示例请求

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

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

HTTP 状态代码

服务返回此部分中的状态代码之一，以响应使用此方法对此资源发出的请求。 对于用于 Xbox Live 服务的标准 HTTP 状态代码的完整列表，请参阅标准 HTTP 状态代码。

代码 原因短语 说明
200 OK 会话成功检索。
301 已永久移动 服务已移至其他 URI。
304 未修改 未修改成就进度。
307 临时重定向 此资源的 URI 已暂时更改。
400 无效的请求 服务无法理解格式错误的请求。 通常是无效参数。
401 未授权 请求需要用户身份验证。
403 已禁止 用户或服务不允许此请求。
404 未找到 找不到指定资源。
406 不可接受 资源版本不受支持；应由 MVC 层拒绝。
408 请求超时 请求完成时间太长。
410 已停用 请求的资源不再可用。

响应正文

响应正文为空。

另请参阅

父级

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