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

# プレイヤーの進行

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

`POST` /data/v1/ingest

## **説明**

ある時点でのプレイヤーのスキルレベルを反映する、関連性のある指標を報告します。この情報は、インシデントに重大度修正を適用するため、プレイヤーの経験に基づいて評判スコアと信頼性スコアを正規化するため、またGGWPのモデレーションツールでインシデントやプレイヤーを確認する際に追加の文脈を提供するために使用されます。

前のセクションで説明したマッチサマリー統計と同様に、進行指標はゲームのジャンルによって大きく異なる場合があるため、ここでも同じガイドラインと例が適用されます。主な違いは、プレイヤー進行がプレイヤーのゲーム時間全体にわたる累積プレイヤー指標を見ている点です。

## **パラメータ**

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

* **type**: `player-progression`
* **user\_id**: ユーザーの一意の識別子。
* **username**: 親しみやすい表示名。
* **date\_joined**: アカウント作成日の *YYYY-MM-DD HH:MM:SS* UTC形式。
* **total\_time\_played**: アカウント作成以降にユーザーがプレイした累計時間（分）。
* **total\_sessions\_played**: アカウント作成以降にユーザーがプレイした総セッション数。
* **user\_level**: 生涯累計レベル。
* **progression\_stats**: 関連する正、負、または中立の統計値の生涯値（マッチサマリーのセクションにある表を参照してください）。
* サンプル呼び出し

  ```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": "player-progression",
    "user_id": "<id1>",
    "username": "SweetPoison",
    "date_joined": "2023-02-24 12:15:07",
    "total_time_played": 805,
    "total_sessions_played": 67,
    "user_level": "75",
    "progression_stats": {
      "positive_stats": {
        "wins": 169,
        "kills": 236,
        "headshots": 54,
        "assists": 295
      },
      "negative_stats": {
        "losses": 198,
        "deaths": 502
      },
      "neutral_stats": {
      }		
    }
  }'
  ```

## **出力**

* 200 - 正常な操作

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