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

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

URI 参数
授权
必需的请求标头
可选的请求标头
请求正文
HTTP 状态代码
响应正文

备注

成功的调用将返回 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) 对象。

请求示例

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	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	请求的资源不再可用。

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

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

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

备注

URI 参数

授权

必需的请求标头

可选的请求标头

请求正文

请求示例

HTTP 状态代码

响应正文

另请参阅

父主题

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

​备注

​URI 参数

​授权

​必需的请求标头

​可选的请求标头

​请求正文

​请求示例

​HTTP 状态代码

​响应正文

​另请参阅

父主题

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

备注

URI 参数

授权

必需的请求标头

可选的请求标头

请求正文

请求示例

HTTP 状态代码

响应正文

另请参阅