> ## 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)。Achievements サービスは、一致するローカライズされた文字列が見つかるまでリストを順に処理します。見つからない場合は、ユーザー トークンで定義された場所 (ユーザーの IP アドレスに由来) との一致を試みます。それでも一致するローカライズ文字列が見つからない場合は、タイトルの開発者/発行者が提供する既定の文字列が使用されます。 |

## リクエスト本文

このリクエストの本文にはオブジェクトは送信されません。

## HTTP ステータス コード

サービスは、このリソースに対するこのメソッドでのリクエストに応じて、このセクション内のいずれかのステータス コードを返します。XBOX Live Services で使用される標準的な HTTP ステータス コードの完全な一覧については、[標準 HTTP ステータス コード](https://devdocs.xbox.com/ja-jp/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| 要求されたリソースは利用できなくなりました。|

## レスポンス本文

### サンプル レスポンス

```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/ja-jp/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidachievementid)


## Related topics

- [XblAchievementsGetAchievementAsync](https://devdocs.xbox.com/fr/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementasync.md)
- [XblAchievementsGetAchievementsForTitleIdAsync](https://devdocs.xbox.com/zh-TW/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementsfortitleidasync.md)
