> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST (/serviceconfigs/{scid}/hoppers/{hoppername})

> POST (/serviceconfigs/{scid}/hoppers/{hoppername})

# POST (/serviceconfigs/{scid}/hoppers/{hoppername})

指定されたマッチ チケットを作成します。

> **重要:**\
> このメソッドは contract 103 以降での使用を想定しており、すべてのリクエストで X-Xbl-Contract-Version: 103 以降のヘッダー要素が必要です。

* [注釈](#ID4ET)
* [URI パラメーター](#ID4E5)
* [承認](#ID4EJB)
* [HTTP ステータス コード](#ID4E3C)
* [リクエスト本文](#ID4EFD)
* [応答本文](#ID4E3G)

## 注釈

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

## URI パラメーター

| パラメーター | 種類 | 説明 |
| - | - | - |
| scid | GUID | セッションのサービス構成識別子 (SCID)。 |
| hoppername | string | ホッパーの名前。 |

## 承認

| 種類 | 必須 | 説明 | 未指定時の応答 |
| - | - | - | - |
| 特権とデバイスの種類 | はい | ユーザーの deviceType が console に設定されている場合、要求内に multiplayer 特権を持つユーザーのみがマッチメイキング サービスへの呼び出しを行うことができます。 | 403 |
| デバイスの種類 | はい | ユーザーの deviceType が存在しないか、コンソール以外に設定されている場合、マッチング対象のタイトルはコンソール専用タイトルであってはなりません。 | 403 |
| タイトル ID/購入証明/デバイスの種類 | はい | マッチング対象のタイトルは、指定されたタイトル要求 (title claim) とデバイスの種類の組み合わせに対してマッチメイキングを許可する必要があります。 | 403 |

## HTTP ステータス コード

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

## リクエスト本文

### 必須メンバー

| メンバー | 種類 | 説明 |
| - | - | - |
| serviceConfig | GUID | セッションの SCID。 |
| hopperName | string | ホッパーの名前。 |
| giveUpDuration | 32 ビット符号付き整数 | 最大待機時間 (整数秒)。 |
| preserveSession | 列挙型 | マッチング先のセッションとしてセッションを再利用するかどうかを示す値。可能な値は "always" と "never" です。 |
| ticketSessionRef | MultiplayerSessionReference | プレーヤーまたはグループが現在プレイしているセッションの MultiplayerSessionReference オブジェクト。 |
| ticketAttributes | オブジェクトのコレクション | ユーザーによってプレーヤー グループについて提供される属性と値。 |

### 禁止されているメンバー

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

### サンプル リクエスト

マッチ チケットを作成する前に、**ticketSessionRef** オブジェクトが参照するセッションを作成する必要があり、そのセッションには、マッチングされるプレーヤーとそのプレーヤー固有の属性を含める必要があります。各プレーヤーは、MPSD に対してセッションを作成または参加し、関連するマッチ属性をセッションに追加する必要があります。マッチ属性は、各プレーヤーの matchAttrs という名前のカスタム プロパティ フィールドに配置されます。

作成または参加リクエストは **[https://sessiondirectory.xboxlive.com/serviceconfigs/\{scid}/sessiontemplates/\{templatename}/sessions/\{sessionname}](https://sessiondirectory.xboxlive.com/serviceconfigs/\{scid}/sessiontemplates/\{templatename}/sessions/\{sessionname})** に送信され、次のようになります:

```cpp theme={null}
{
   "members": {
     "me": {
       "constants": {
         "system": {
           "xuid": 2535285330879750
         }
      },
      "properties": {
         "custom": {
           "matchAttrs": {
             "skill": 5,
             "ageRange": "teenager"
           }
         }
      }
    }
  }
}

```

セッションが作成されると、タイトルはマッチメイキング サービスを呼び出して、そのセッションの ticket を作成できます。

> **注:**
> タイトルはユーザーがこの呼び出しを再試行できるようにすることはできますが、データが失敗した場合に自動的に再試行しないようにしてください。

```cpp theme={null}
POST /serviceconfigs/{scid}/hoppers/{hoppername}

{
  "giveUpDuration":10,
  "preserveSession": "never",
  "ticketSessionRef": {
     "scid": "ABBACDDC-0000-0000-0000-000000000001",  
     "templateName": "TestTemplate",
     "name": "5E55104-0000-0000-0000-000000000001"
  },
  "ticketAttributes": {
    "desiredMap": "Test Map",
    "desiredGameType": "Test GameType"
  }
}

```

## 応答本文

| メンバー | 種類 | 説明 |
| - | - | - |
| ticketId | GUID | 作成される ticket の ID。 |
| waitTime | 32 ビット符号付き整数 | ホッパーの平均待機時間 (整数秒)。 |

```cpp theme={null}
{
  "ticketId":"0584338f-a2ff-4eb9-b167-c0e8ddecae72",
  "waitTime":60
}

```

## 関連項目

## 親

[/serviceconfigs/{scid}/hoppers/{hoppername}](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/matchtickets/uri-serviceconfigsscidhoppershoppername)


## Related topics

- [Multiplayer tasks](https://devdocs.xbox.com/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [Tarefas de multijogador](https://devdocs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [Tareas multijugador](https://devdocs.xbox.com/es/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [Tâches multijoueurs](https://devdocs.xbox.com/fr-CA/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [XblMatchmakingGetHopperStatisticsAsync](https://devdocs.xbox.com/reference/live/xsapi-c/matchmaking_c/functions/xblmatchmakinggethopperstatisticsasync.md)