> 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/teremetori.md).

# テレメトリ

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

`POST` /data/v1/ingest

## **説明**

個々の試合またはセッションに対応するゲームプレイのテレメトリデータを報告し、ゲーム進行中の特定のプレイヤー行動を追跡します。この情報は、特定の事象（例：AFK、フレンドリーファイア、意図的なフィード…）を確認するためや、GGWPのモデレーションツールで事象やプレイヤーを確認する際に追加の文脈を提供するために使用できます。

ゲームが記録している一般的なテレメトリイベントには、次のようなものがあります：

* セッションの開始/終了時刻
* プレイヤーの位置
* プレイヤーの行動 - 移動、攻撃、プレイ、アイテム取得、死亡、蘇生など。

## **パラメータ**

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

* **type**: `テレメトリ`
* **session\_id**: 試合の一意の識別子。
* **開始時刻**: 試合開始時刻の *YYYY-MM-DD HH:MM:SS* UTC形式。
* **終了時刻**: 試合終了時刻の *YYYY-MM-DD HH:MM:SS* UTC形式。
* **イベント**: 各要素が辞書で表されるイベントログの一覧。
* サンプル呼び出し

  ```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": "テレメトリ",
    "セッションID": "<id1>",	
    "start_time": "2022-01-25 09:44:00",
    "end_time": "2022-01-25 10:12:23",
    "イベント": [
      {
        "event_type": "プレイヤーセッション開始", 
        "timestamp": "2022-01-25 09:43:35",
        "user_id": "<id1>",
        "team_id": "1",
        "event_details": {}
      },
      {
        "event_type": "プレイヤー位置", 
        "timestamp": "2022-01-25 09:44:30",
        "user_id": "<id1>",
        "team_id": "1",
        "event_details": {
          "位置": {
            "x": 103450,
            "y": 200560,
            "z": 102
          }
        }
      },
      {
        "event_type": "プレイヤー行動", 
        "timestamp": "2022-01-25 09:45:13",
        "user_id": "<id1>",
        "team_id": "1",
        "event_details": {
          "action_type": "攻撃",   
          "action_target": "<id3>",
          "位置": {
            "x": 421450,
            "y": 113460,
            "z": 10
          },
          "ダメージ": 50,
          "武器": "銃"
        }
      },
      ...
    ] 
  }'
  ```

## **出力**

* 200 - 正常な操作

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