POST (/batch)
複数タイトルをまたがる複数プレイヤーの統計を求める複雑なバッチ要求の GET メソッドとして機能する POST メソッド。
これらの URI のドメインは userstats.xboxlive.com です。
備考
タイトル開発者は、パートナー センターでオープンまたは制限付きとして統計をマークできます。 ランキングはオープン統計です。 オープン統計には、ユーザーがサンドボックスから承認されている場合に SmartGlass、iOS、Android、Windows、Windows Phone、および Web アプリケーションからアクセスできます。 サンドボックスへのユーザー承認はパートナー センターで管理されます。
説明
呼び出し元は、メッセージの本体に、ユーザーの配列、サービス構成 ID (SCID)、およびこれらの統計を取得する SCID ごとの統計名リストを提供します。
この複雑なバッチ モード ページを読む前に、シンプルな単一統計 GET メソッドを確認するほうが便利な場合があります。
Authorization
コンテンツの分離とアクセス制御の各シナリオ用に実装された承認ロジックがあります。
- ランキングとユーザー統計はどちらも、呼び出し元が要求と共に有効な XSTS トークンを送信した場合に、任意のプラットフォームのクライアントから読み取ることができます。 書き込みは当然ながら、サポートされているクライアントに限定されます。
- タイトル開発者は、パートナー センターでオープンまたは制限付きとして統計をマークできます。 ランキングはオープン統計です。 オープン統計には、ユーザーがサンドボックスから承認されている場合に SmartGlass、iOS、Android、Windows、Windows Phone、および Web アプリケーションからアクセスできます。 サンドボックスへのユーザー承認はパートナー センターで管理されます。
次の例は、チェック用の擬似コードです。
If (!checkAccess(serviceConfigId, resource, CLAIM[userid, deviceid, titleid]))
{
Reject request as Unauthorized
}
// else accept request.
必須の要求ヘッダー
| ヘッダー | 型 | 説明 |
|---|---|---|
| Authorization | 文字列 | HTTP 認証用の認証資格情報。 例の値:「XBL3.0 x=<userhash>;<token>」。 |
省略可能な要求ヘッダー
| ヘッダー | 型 | 説明 |
|---|---|---|
| X-RequestedServiceVersion | この要求の送信先であるサービスのビルド名/番号。 要求は、ヘッダー、認証トークン内のクレームなどの有効性が確認された後でのみ、そのサービスにルーティングされます。 既定値: 1。 |
リクエストの本文
サンプル要求
次の POST の本文は、2 人のユーザーの 2 つの SCID から 4 つの統計が要求されていることをサービスに通知します。
{
"requestedusers": [
1234567890123460,
1234567890123234
],
"requestedscids": [
{
"scid": "c402ff50-3e76-11e2-a25f-0800200c1212",
"requestedstats": [
"Test4FirefightKills",
"Test4FirefightHeadshots"
]
},
{
"scid": "c402ff50-3e76-11e2-a25f-0800200c0343",
"requestedstats": [
"OverallTestKills",
"TestHeadshots"
]
}
]
}
HTTP ステータス コード
サービスは、このリソースに対してこのメソッドで実行された要求に応答して、このセクションのステータス コードのいずれかを返します。 Xbox Live サービスで使用される標準 HTTP ステータス コードの一覧については、「標準 HTTP ステータス コード」を参照してください。
| コード | 理由 | 説明 |
|---|---|---|
| 200 | OK | セッションは正常に取得されました。 |
| 304 | 変更なし | リソースは最後の要求以降、変更されていません。 |
| 400 | Bad Request | サービスは無効な形式の要求を解釈できませんでした。 通常は、無効なパラメーターです。 |
| 401 | 未承認 | 要求にはユーザー認証が必要です。 |
| 403 | Forbidden | ユーザーまたはサービスに対して要求が許可されていません。 |
| 404 | Not Found | 指定されたリソースが見つかりませんでした。 |
| 406 | Not Acceptable | リソースのバージョンがサポートされていません。 |
| 408 | Request Timeout | リソースのバージョンがサポートされていません。MVC レイヤーによって拒否されます。 |
応答の本文
サンプル応答
{
"users":[
{
"xuid": "123456789"
"gamertag": "WarriorSaint",
"scids":[
{
"scid":"c402ff50-3e76-11e2-a25f-0800200c1212",
"stats": [
{
"statname":"Test4FirefightKills",
"type":"Integer",
"value":7
},
{
"statname":"Test4FirefightHeadshots",
"type":"Integer",
"value":4
}]
},
{
"scid":"c402ff50-3e76-11e2-a25f-0800200c0343",
"stats": [
{
"statname":"OverallTestKills",
"type":"Integer",
"value":3434
},
{
"statname":"TestHeadshots",
"type":"Integer",
"value":41
}]
}],
},
{
"gamertag":"TigerShark",
"xuid":1234567890123234
"scids":[
{
"scid":"123456789",
"stats": [
{
"statname":"Test4FirefightKills",
"type":"Integer",
"value":63
},
{
"statname":"Test4FirefightHeadshots",
"type":"Integer",
"value":12
}]
},
{
"scid":"987654321",
"stats": [
{
"statname":"OverallTestKills",
"type":"Integer",
"value":375
},
{
"statname":"TestHeadshots",
"type":"Integer",
"value":34
}]
}],
}]
}