POST (/batch)

複数タイトルにまたがる複数プレイヤーの統計情報に対する複雑なバッチ要求のために、GET メソッドとして機能する POST メソッド。これらの URI のドメインは userstats.xboxlive.com です。

解説

タイトル開発者はパートナーセンターを使用して、統計を open または restricted としてマークできます。リーダーボードは open 統計です。open 統計は、ユーザーがサンドボックスに対して認可されている限り、Smartglass、iOS、Android、Windows、Windows Phone、および Web アプリケーションからアクセスできます。サンドボックスに対するユーザーの認可は、パートナーセンターを通じて管理されます。

解説
説明
認可
必須要求ヘッダー
省略可能な要求ヘッダー
要求本文
HTTP 状態コード
応答本文

説明

呼び出し元は、それらの統計を取得するためのユーザー、サービス構成 ID (SCID)、および SCID ごとの統計名リストの配列を含むメッセージ本文を提供します。より複雑なバッチモードのこのページを読む前に、単純な単一統計の GET メソッドを確認するとより理解しやすい場合があります。

認可

コンテンツの分離とアクセス制御のシナリオを実装する認可ロジックがあります。

リーダーボードとユーザー統計はいずれも、呼び出し元が要求と共に有効な XSTS トークンを送信していれば、任意のプラットフォームのクライアントから読み取ることができます。書き込みは、当然サポートされているクライアントに限られます。
タイトル開発者はパートナーセンターを使用して、統計を open または restricted としてマークできます。リーダーボードは open 統計です。open 統計は、ユーザーがサンドボックスに対して認可されている限り、Smartglass、iOS、Android、Windows、Windows Phone、および Web アプリケーションからアクセスできます。サンドボックスに対するユーザーの認可は、パートナーセンターを通じて管理されます。

次の例は、チェックの疑似コードです。

If (!checkAccess(serviceConfigId, resource, CLAIM[userid, deviceid, titleid]))
{
        Reject request as Unauthorized
}

// else accept request.
         

必須要求ヘッダー

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

省略可能な要求ヘッダー

| ヘッダー | 型 | 説明 | | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion | | この要求がルーティングされるサービスのビルド名/番号。要求は、ヘッダーの妥当性、認証トークンのクレームなどが確認された後にのみ、そのサービスにルーティングされます。既定値: 1。 |

要求本文

要求例

次の POST 本文は、4 つの統計を 2 つの異なる SCID から 2 人の異なるユーザーに対して要求していることをサービスに通知します。

{    
"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 | Not Modified | 前回要求されてからリソースが変更されていません。 | | 400 | Bad Request | サービスは正しくない形式の要求を解釈できませんでした。通常は無効なパラメーターです。 | | 401 | Unauthorized | 要求にはユーザー認証が必要です。 | | 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
             }]
          }],
                   }]
}
         

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

POST (/batch)

POST (/batch)

解説

説明

認可

必須要求ヘッダー

省略可能な要求ヘッダー

要求本文

要求例

HTTP 状態コード

応答本文

応答例

関連項目

親

​POST (/batch)

​解説

​説明

​認可

​必須要求ヘッダー

​省略可能な要求ヘッダー

​要求本文

​要求例

​HTTP 状態コード

​応答本文

​応答例

​関連項目

親

POST (/batch)

解説

説明

認可

必須要求ヘッダー

省略可能な要求ヘッダー

要求本文

要求例

HTTP 状態コード

応答本文

応答例

関連項目