Skip to main content

POST (/serviceconfigs//hoppers/)

指定されたマッチ チケットを作成します。
重要:
このメソッドは contract 103 以降での使用を想定しており、すべてのリクエストで X-Xbl-Contract-Version: 103 以降のヘッダー要素が必要です。

注釈

この HTTP/REST メソッドは、サービス構成 ID (SCID) レベルで、特定の名前のホッパーに対してマッチ チケットを作成します。このメソッドは Microsoft.Xbox.Services.Matchmaking.MatchmakingService.CreateMatchTicketAsync メソッドによってラップできます。

URI パラメーター

承認

HTTP ステータス コード

サービスは、MPSD に対して適用される HTTP ステータス コードを返します。

リクエスト本文

必須メンバー

禁止されているメンバー

その他のメンバーはリクエストで禁止されています。

サンプル リクエスト

マッチ チケットを作成する前に、ticketSessionRef オブジェクトが参照するセッションを作成する必要があり、そのセッションには、マッチングされるプレーヤーとそのプレーヤー固有の属性を含める必要があります。各プレーヤーは、MPSD に対してセッションを作成または参加し、関連するマッチ属性をセッションに追加する必要があります。マッチ属性は、各プレーヤーの matchAttrs という名前のカスタム プロパティ フィールドに配置されます。 作成または参加リクエストは https://sessiondirectory.xboxlive.com/serviceconfigs/{scid}/sessiontemplates/{templatename}/sessions/{sessionname} に送信され、次のようになります:
セッションが作成されると、タイトルはマッチメイキング サービスを呼び出して、そのセッションの ticket を作成できます。
注: タイトルはユーザーがこの呼び出しを再試行できるようにすることはできますが、データが失敗した場合に自動的に再試行しないようにしてください。

応答本文

関連項目

親

/serviceconfigs//hoppers/
Last modified on October 19, 2026