次の方法で共有

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

  • [アーティクル]

実績の詳細を取得します。 これらの URI のドメインは achievements.xboxlive.com です。

URI パラメーター

パラメーター 型 説明
xuid 64 ビット符号なし整数 アクセスしようとしているリソースを保持しているユーザーの Xbox ユーザー ID (XUID)。 認証されたユーザーの XUID と一致する必要があります。
scid GUID アクセスする実績を含むサービス構成の一意の識別子。
achievementid 32 ビット符号なし整数 アクセスする実績の (指定された SCID 内で) 一意の識別子。

Authorization

使用される承認クレーム クレーム 必須かどうか 説明 存在しない場合の動作
ユーザー ○ 要求の対象である Xbox LIVE 上の有効なユーザー。 403 Forbidden
タイトル × 呼び出し元のタイトル。 AuthZ によって異なります。 2013 年 5 月 1 日現在、AuthZ は存在しない場合にクレームを提供しないため、パブリックとしてマークされていない SCID へのアクセスを拒否します。
Sandbox × 結果の取得元であるサンドボックス。 AuthZ によって異なります。 2013 年 5 月 1 日現在、AuthZ は存在しない場合に既定のクレームを提供しません。

プライバシー設定がリソースに与える影響

プライバシー設定がリソースに与える影響 要求元のユーザー ターゲット ユーザーのプライバシー設定 動作
自分 - 説明のとおり。
フレンド すべての人 OK
フレンド フレンドのみ OK
フレンド 制限 禁止。
フレンドではないユーザー すべての人 OK
フレンドではないユーザー フレンドのみ 禁止。
フレンドではないユーザー 制限 禁止。
サードパーティーのサイト すべての人 OK
サードパーティーのサイト フレンドのみ 禁止。
サードパーティーのサイト 制限 禁止。

必須の要求ヘッダー

ヘッダー 型 説明
Authorization 文字列 HTTP 認証用の認証資格情報。 例の値: "XBL3.0 x=<userhash>;<token>"。

省略可能な要求ヘッダー

ヘッダー 型 説明
X-RequestedServiceVersion 文字列 この要求の送信先である Xbox LIVE サービスのビルド名/番号。 要求は、ヘッダー、認証トークン内のクレームなどの有効性が確認された後でのみ、そのサービスにルーティングされます。 既定値: 1。
x-xbl-contract-version 文字列 既定は、V1 です。
Accept-Language 文字列 目的のロケールとフォールバックのリスト (fr-FR、fr、en-GB、en-WW、en-US など)。 実績サービスは、一致するローカライズされた文字列が見つかるまでリストを処理します。 見つからない場合は、ユーザーの IP アドレスを元に取得した、ユーザーのトークンで定義されている場所との一致を試みます。 それでもまだ一致するローカライズされた文字列が見つからない場合は、タイトルのデベロッパー/パブリッシャーによって提供された既定の文字列を使用します。

リクエストの本文

この要求の本体で送信されるオブジェクトはありません。

HTTP ステータス コード

サービスは、このリソースに対してこのメソッドで実行された要求に応答して、このセクションのステータス コードのいずれかを返します。 Xbox Live サービスで使用される標準 HTTP ステータス コードの一覧については、「標準 HTTP ステータス コード」を参照してください。

コード 理由 説明
200 OK セッションは正常に取得されました。
301 Moved Permanently サービスは別の URI に移動されました。
307 Temporary Redirect このリソースの URI が一時的に変更されています。
400 Bad Request サービスは無効な形式の要求を解釈できませんでした。 通常は、無効なパラメーターです。
401 未承認 要求にはユーザー認証が必要です。
403 Forbidden ユーザーまたはサービスに対して要求が許可されていません。
404 Not Found 指定されたリソースが見つかりませんでした。
406 Not Acceptable リソースのバージョンがサポートされていません。MVC レイヤーによって拒否されます。
408 Request Timeout 所定の時間内に要求を完了できませんでした。
410 Gone 要求されたリソースが利用不能になりました。

応答の本文

サンプル応答

{
    "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}