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

# プレイヤーIDの連携

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

`POST` /data/v1/ingest

## **説明**

異なる関連プラットフォーム（例: ゲーム内、Discord など）にまたがるプレイヤーの一意の識別子間の関連を記録します。この情報は、関連するすべての情報（インシデント、報告、アクティビティなど）をプレイヤー単位で集約し、各プラットフォームにおけるそのプレイヤーの評判を包括的に把握するために使用されます。

## **パラメータ**

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

* **type**: `player-id-link`
* **user\_id**: ゲーム内でのユーザーの一意の識別子。
* **username**: ゲーム内でユーザーが選んだ親しみやすい表示名。
* **platform\_name**: `discord` / `twitch` / `twitter`
* **platform\_id**: 対応するソーシャルプラットフォームにおけるユーザーの一意の識別子。
* **platform\_username**: 対応するソーシャルプラットフォームでユーザーが選んだ親しみやすい表示名。
* サンプル呼び出し

  ```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-id-link",
    "user_id": "<id1>",
    "username": "nlxdz",
    "platform_name": "discord",
    "platform_id": "<id2>",
    "platform_username": "Avocadorable"
  }'
  ```

## **出力**

* 200 - 正常な操作

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