Post Server Recent Players

複数のユーザーの最近のプレイヤーリストに追加または更新します (一方向)。これは基本的に、サーバー向けのクライアント API のバッチ API です。この API を使用すると、ゲームサーバーは複数のユーザーの最近のプレイヤーリストに追加し、既存の最近のプレイヤーエントリを更新できます。各ユーザーの最近のプレイヤーリストは一方向です。

POST /titles/{titleId}/recentplayers/server

URI パラメーター

パラメーター	場所	必須	種類	説明
titleId	path	TRUE	integer	リクエストが送信されているゲームの titleId。

リクエストヘッダー

名前	必須	種類	説明
Authorization	TRUE	integer	呼び出し元は XBL 3.0 承認形式で XToken を指定する必要があります。例: Authorization: XBL3.0 x=2553948354698;>encrypted token<)
Content-Type	TRUE	string	ContentType は application/json に設定する必要があります

リクエスト本文

名前	必須	種類	説明
recentPlayersByXuid	TRUE	ServerRecentPlayersByXuid[]	XUID とその最近のプレイヤーを表すオブジェクトの配列。少なくとも 1 つ、最大 20 の XUID エントリを指定する必要があります。

応答

名前	種類	説明
204 No Content		最近のプレイヤーリクエストが正常に送信されました。
400 Bad Request	ErrorResponse	リクエスト処理中にエラーが発生しました。可能なエラーコード: “RequestValidationError: The request validation has failed.”, ” AuthorizationError: The caller is not allowed to access the resource.”
その他のステータスコード	ThrottledEntity	リクエストが多すぎます。ヘッダー Retry-After: integer

EncounterType

最近のプレイヤーとの遭遇の種類。このフィールドは省略可能で、既定値は Default です。Default には所定の意味はありません。呼び出し元がこの値を適切に解釈する必要があります。

名前	種類	説明
Default	string
Opponent	string
Teammate	string

ErrorResponse

名前	種類	説明
debugMessage	string	デバッグに使用できる、人間が読めるエラーメッセージのバージョン。
errorCode	string	エラーコード列挙型。

Network

名前	種類	説明
XboxLive	string

ServerRecentPlayersByXuid

名前	種類	説明
recentPlayers	UnidirectionalRecentPlayer[]	このユーザーの最近のプレイヤーの配列。少なくとも 1 人の最近のプレイヤー、最大 100 人を指定する必要があります。
xuid	string	ユーザーの XUID (基数 10 の整数)。

ServerRecentPlayersRequest

名前	種類	説明
recentPlayersByXuid	ServerRecentPlayersByXuid[]	XUID とその最近のプレイヤーを表すオブジェクトの配列。少なくとも 1 つ、最大 20 の XUID エントリを指定する必要があります。

ThrottledEntity

名前	種類	説明
currentRequests	string	現在のリクエスト数 - 同時実行またはレート。
debugMessage	string	デバッグに使用できる、人間が読めるスロットルメッセージのバージョン。
limitType	string	制限の種類 (同時実行またはレート)。
maxRequests	string	許容される最大リクエスト数 - 同時実行またはレート。
periodInSeconds	string	レートまたは同時実行の制限を超えたときに適用される期間 (秒単位)。
version	string	現在のスロットルコントラクトのバージョン。

UnidirectionalRecentPlayer

名前	種類	説明
encounterType	EncounterType	最近のプレイヤーとの遭遇の種類。このフィールドは省略可能で、既定値は Default です。Default には所定の意味はありません。呼び出し元がこの値を適切に解釈する必要があります。
id	string	別のユーザーの Id (基数 10 の整数の XUID)。
network	Network	相手ユーザーと会ったネットワーク。
timestamp	string

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

POST /titles/{titleId}/recentplayers/server

Post Server Recent Players

URI パラメーター

リクエストヘッダー

リクエスト本文

応答

定義

EncounterType

ErrorResponse

Network

ServerRecentPlayersByXuid

ServerRecentPlayersRequest

ThrottledEntity

UnidirectionalRecentPlayer

​Post Server Recent Players

​URI パラメーター

​リクエスト ヘッダー

​リクエスト本文

​応答

​定義

​EncounterType

​ErrorResponse

​Network

​ServerRecentPlayersByXuid

​ServerRecentPlayersRequest

​ThrottledEntity

​UnidirectionalRecentPlayer

Post Server Recent Players

URI パラメーター

リクエストヘッダー

リクエスト本文

応答

定義

EncounterType

ErrorResponse

Network

ServerRecentPlayersByXuid

ServerRecentPlayersRequest

ThrottledEntity

UnidirectionalRecentPlayer