> ## 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.

# GET (/users/xuid({xuid})/achievements/{scid}/{achievementid})

> GET (/users/xuid({xuid})/achievements/{scid}/{achievementid})

# GET (/users/xuid({xuid})/achievements/{scid}/{achievementid})

获取该成就的详细信息。
这些 URI 的域为 `achievements.xboxlive.com`。

* [URI 参数](#ID4EV)
* [授权](#ID4EAB)
* [隐私设置对资源的影响](#ID4E4C)
* [必需的请求标头](#ID4EPG)
* [可选的请求标头](#ID4EPH)
* [请求正文](#ID4ECBAC)
* [HTTP 状态代码](#ID4ENBAC)
* [响应正文](#ID4EBGAC)

## URI 参数

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

## 授权

使用的授权声明 | 声明 | 是否必需? | 说明 | 缺失时的行为 |
\| --- | --- | --- | --- |
\| User | 是 | 为其发起请求的 XBOX LIVE 上的有效用户。 | 403 Forbidden |
\| Title | 否 | 调用方标题。 | 取决于 AuthZ。截至 2013 年 5 月 1 日,AuthZ 在缺失时不会提供声明,因此将拒绝访问任何未标记为公共的 SCID。 |
\| Sandbox | 否 | 应从中检索结果的沙盒。 | 取决于 AuthZ。截至 2013 年 5 月 1 日,AuthZ 在缺失时不会提供默认声明。 |

## 隐私设置对资源的影响

隐私设置对资源的影响 | 请求用户 | 目标用户的隐私设置 | 行为 |
\| --- | --- | --- |
\| me | - | 如所述。 |
\| friend | everyone | OK |
\| friend | friends only | OK |
\| friend | blocked | Forbidden。 |
\| non-friend user | everyone | OK |
\| non-friend user | friends only | Forbidden。 |
\| non-friend user | blocked | Forbidden。 |
\| third-party site | everyone | OK |
\| third-party site | friends only | Forbidden。 |
\| third-party site | blocked | Forbidden。 |

## 必需的请求标头

| 标头 | 类型 | 说明 |
| - | - | - |
| Authorization | string | 用于 HTTP 身份验证的凭据。示例值:"XBL3.0 x=\<userhash>;\<token>"。 |

## 可选的请求标头

| 标头 | 类型 | 说明 |
| - | - | - |
| X-RequestedServiceVersion | string | 此请求应发送到的 XBOX LIVE 服务的生成名称/编号。仅在验证标头的有效性、认证令牌中的声明等之后,请求才会被路由到该服务。默认值:1。 |
| x-xbl-contract-version | string | 默认为 V1。 |
| Accept-Language | string | 所需区域设置和回退项的列表(例如,fr-FR、fr、en-GB、en-WW、en-US)。成就服务将逐个检查该列表,直到找到匹配的本地化字符串。如果未找到,则尝试匹配用户令牌中定义的位置,该位置来自用户的 IP 地址。如果仍未找到匹配的本地化字符串,则使用标题开发者/发行商提供的默认字符串。 |

## 请求正文

此请求的正文中不发送任何对象。

## HTTP 状态代码

服务针对使用此方法对此资源发出的请求,返回本节中的某个状态代码。有关与 XBOX Live 服务一同使用的标准 HTTP 状态代码的完整列表,请参见 [标准 HTTP 状态代码](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/httpstatuscodes.md)。

| 代码 | 原因短语 | 说明 |
| - | - | - |
| 200 | OK | 已成功检索会话。 |
| 301 | Moved Permanently | 该服务已移至其他 URI。 |
| 307 | Temporary Redirect | 此资源的 URI 已临时更改。 |
| 400 | Bad Request | 服务无法理解格式错误的请求。通常是无效参数。 |
| 401 | Unauthorized | 请求需要用户身份验证。 |
| 403 | Forbidden | 不允许该用户或服务发出请求。 |
| 404 | Not Found | 找不到指定的资源。 |
| 406 | Not Acceptable | 不支持资源版本;应由 MVC 层拒绝。 |
| 408 | Request Timeout | 请求完成时间过长。 |
| 410 | Gone | 请求的资源不再可用。 |

## 响应正文

### 响应示例

```cpp theme={null}
{
    "achievement":
    {
        "id":"3",
        "serviceConfigId":"b5dd9daf-0000-0000-0000-000000000000",
        "name":"Default NameString for Microsoft Achievements Sample Achievement 3",
        "titleAssociations":
        [{
                "name":"Microsoft Achievements Sample",
                "id":3051199919,
                "version":"abc"
        }],
        "progressState":"Achieved",
        "progression":
        {
                "requirements":null,
                "timeUnlocked":"2013-01-17T03:19:00.3087016Z",
        },
        "mediaAssets":
        [{
                "name":"Icon Name",
                "type":"Icon",
                "url":"http://www.xbox.com"
        }],
        "platform":"D",
        "isSecret":true,
        "description":"Default DescriptionString for Microsoft Achievements Sample Achievement 3",
        "lockedDescription":"Default UnachievedString for Microsoft Achievements Sample Achievement 3",
        "productId":"12345678-1234-1234-1234-123456789012",
        "achievementType":"Challenge",
        "participationType":"Individual",
        "timeWindow":
        {
                "startDate":"2013-02-01T00:00:00Z",
                "endDate":"2100-07-01T00:00:00Z"
        },
        "rewards":
        [{
                "name":null,
                "description":null,
                "value":"10",
                "type":"Gamerscore",
                "valueType":"Int"
        },
        {
                "name":"Default Name for InAppReward for Microsoft Achievements Sample Achievement 3",
                "description":"Default Description for InAppReward for Microsoft Achievements Sample Achievement 3",
                "value":"1",
                "type":"InApp",
                "valueType":"String"
        }],
        "estimatedTime":"06:12:14",
        "deeplink":"aWFtYWRlZXBsaW5r",
        "isRevoked":false
    }
}
         
```

## 另请参阅

##### 父主题

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


## Related topics

- [/users/xuid({xuid})/achievements/{scid}/{achievementid}](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidachievementid.md)
- [/users/xuid({xuid})/achievements/{scid}/update](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidupdate.md)
- [POST (/users/xuid({xuid})/achievements/{scid}/update)](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidupdatepost.md)
- [GET (/users/xuid({xuid})/achievements)](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/achievements/uri-achievementsusersxuidachievementsgetv2.md)
- [/users/xuid({xuid})/achievements](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/achievements/uri-achievementsusersxuidachievementsv2.md)