POST (/users/xuid({xuid})/achievements/{scid}/update)
実績の進行状況を更新します。
これらの URI のドメインは achievements.xboxlive.com です。
解説
- 正常な呼び出しでは、空の応答本文を持つ 200 の HTTP 状態コードが返されます。
- 呼び出しの結果、実績の進行状況に変化がない場合 (つまり、既にロックが解除されているか、同じ完了率である場合)、呼び出しは空の応答本文を含む HTTP 状態コード 304 を返します。
URI パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| xuid | 64 ビット符号なし整数 | アクセスしようとしているリソースを保持しているユーザーの Xbox ユーザー ID (XUID)。 認証されたユーザーの XUID と一致する必要があります。 |
| scid | GUID | アクセスする実績を含むサービス構成の一意の識別子。 |
Authorization
| クレーム | 必須かどうか | 説明 | 存在しない場合の動作 |
|---|---|---|---|
| ユーザー | ○ | 要求の対象である Xbox LIVE 上の有効なユーザー。 | 403 Forbidden |
必須の要求ヘッダー
| ヘッダー | 型 | 説明 |
|---|---|---|
| Authorization | 文字列 | HTTP 認証用の認証資格情報。 例の値: "XBL3.0 x=<userhash>;<token>"。 |
| x-xbl-contract-version | 2 | API コントラクトのバージョン。 |
省略可能な要求ヘッダー
| ヘッダー | 型 | 説明 |
|---|---|---|
| Accept-Language | 文字列 | 目的のロケールとフォールバックのリスト (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 | 変更なし | 実績の進行状況は変更されませんでした。 |
| 307 | Temporary Redirect | このリソースの URI が一時的に変更されています。 |
| 400 | Bad Request | サービスは無効な形式の要求を解釈できませんでした。 通常は、無効なパラメーターです。 |
| 401 | 未承認 | 要求にはユーザー認証が必要です。 |
| 403 | Forbidden | ユーザーまたはサービスに対して要求が許可されていません。 |
| 404 | Not Found | 指定されたリソースが見つかりませんでした。 |
| 406 | Not Acceptable | リソースのバージョンがサポートされていません。MVC レイヤーによって拒否されます。 |
| 408 | Request Timeout | 所定の時間内に要求を完了できませんでした。 |
| 410 | Gone | 要求されたリソースが利用不能になりました。 |
応答の本文
応答本文が空です。