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

<a id="ID4EV" />

## URI 參數

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

<a id="ID4EAB" />

## 授權

使用的授權宣告 | 宣告| 必要?| 描述| 遺漏時的行為|
\| --- | --- | --- | --- | --- | --- | --- |
\| User| 是| 提出要求之 XBOX LIVE 上的有效使用者。| 403 Forbidden|
\| Title| 否| 呼叫的遊戲。| 取決於 AuthZ。自 2013 年 5 月 1 日起，AuthZ 在遺漏時不會提供宣告，因此將拒絕存取任何未標示為公開的 SCID。|
\| Sandbox| 否| 應從中擷取結果的沙箱。| 取決於 AuthZ。自 2013 年 5 月 1 日起，AuthZ 在遺漏時不會提供預設宣告。|

<a id="ID4E4C" />

## 隱私權設定對資源的影響

隱私權設定對資源的影響 | 要求的使用者| 目標使用者的隱私權設定| 行為|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| me| -| 如所述。|
\| 朋友| 所有人| OK|
\| 朋友| 僅限朋友| OK|
\| 朋友| 已封鎖| 禁止。|
\| 非朋友使用者| 所有人| OK|
\| 非朋友使用者| 僅限朋友| 禁止。|
\| 非朋友使用者| 已封鎖| 禁止。|
\| 協力廠商網站| 所有人| OK|
\| 協力廠商網站| 僅限朋友| 禁止。|
\| 協力廠商網站| 已封鎖| 禁止。|

<a id="ID4EPG" />

## 必要的要求標頭

\| 標頭| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| string| HTTP 驗證的驗證認證。範例值："XBL3.0 x=\<userhash>;\<token>"。|

<a id="ID4EPH" />

## 選用的要求標頭

\| 標頭| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 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 位址。如果仍然找不到相符的當地語系化字串，則會使用遊戲開發人員/發行者提供的預設字串。 |

<a id="ID4ECBAC" />

## 要求本文

此要求的本文中不會傳送任何物件。

<a id="ID4ENBAC" />






## HTTP 狀態碼

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

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

<a id="ID4EBGAC" />

## 回應本文

<a id="ID4EHGAC" />

### 範例回應

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

<a id="ID4ERGAC" />

## 另請參閱

<a id="ID4ETGAC" />

##### 上層

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


## Related topics

- [XblAchievementsGetAchievementAsync](/ko/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementasync.md)
- [XblAchievementsGetAchievementsForTitleIdAsync](/ko/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementsfortitleidasync.md)