> For the complete documentation index, see [llms.txt](https://docs.ggwp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ggwp.com/jp/apidokyumento-kontekisuto/shi-he-qing-bao.md).

# 試合情報

\[ ベース URL: `api.ggwp.com`]

`POST` /data/v1/ingest

## **説明**

新しい試合イベントを定義する関連情報を報告します。この情報は、インシデントに重大度の修正を適用し、時間の経過に伴ってプレイヤーのパーティを追跡し、GGWPのモデレーションツールでインシデントやプレイヤーを確認する際に追加の文脈を提供するために使用されます。

## **パラメータ**

`ボディ`: 次のフィールドを含む辞書:

* **type**: `試合情報`
* **session\_id**: 試合の一意の識別子。
* **セッション種別**: 試合の種類またはモードを説明する文字列。例: `カジュアル`, `競技`, `カスタム`.
* **プレイヤー**：すべてのプレイヤー参加者とチームの一覧。関連する項目の例としては、次のようなものがあります：
  * **user\_id**: ユーザーの一意の識別子。
  * **username**: 親しみやすい表示名。
  * **チームID**: チームの識別子。
  * **パーティID**: 一緒にキューに並んでいるプレイヤーのパーティを関連付ける識別子。
  * **キャラクター名**: プレイヤーが選択したキャラクターの名前。
  * **user\_level**: 現在のプレイヤーレベル。
* サンプル呼び出し

  ```bash
  curl --request POST 'https://api.ggwp.com/data/v1/ingest' \\
  --header 'x-api-key: api_key' \\
  --header 'Content-Type: application/json' \\
  --data-raw '{
    "type": "試合情報",
    "session_id": "<sessionID1>",
    "session_type": "競技",
    "players": [
      {
        "user_id": "<id1>",
        "username": "nlxdz",
        "team_id": "1",
        "party_id": "1",
        "character_name": "Dracarys",
        "user_level": "50"
      },
      {
        "user_id" "<id2>",
        ...
      }
    ]
  }'
  ```

## **出力**

* 200 - 正常な操作

  ```json
  {
    "status": "success"
  }
  ```
* 400
  * エラーレスポンス。イベントはシステムに挿入されていません。このエラーは次のケースで発生します：
    * `無効な本文。JSON入力が必要です`
      * データペイロードはJSON形式ではありません
    * `データペイロードが大きすぎます`
      * データペイロードのサイズが1MBを超えています
* 403
  * 無効なAPIキー、またはAPIキーがありません。
* 500
  * エラーレスポンス。イベントはシステムに挿入されていません。リクエストの処理中にサーバー側でエラーが発生しました。