> 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/chinese-simplified/api-wen-dang-shang-xia-wen-xin-xi/wan-jia-id-guan-lian.md).

# 玩家 ID 关联

\[ 基础 URL: `api.ggwp.com`]

`POST` /data/v1/ingest

## **描述**

记录玩家在不同相关平台（例如：游戏内、Discord 等）之间的唯一标识符关联。此信息用于在玩家层面汇总所有相关信息（事件、举报、活动……），并提供该玩家跨平台声誉的整体视图。

## **参数**

`请求体`：包含以下字段的字典：

* **类型**: `玩家ID关联`
* **user\_id**: 用户在游戏内的唯一标识符。
* **用户名**: 用户在游戏内选择的友好显示名称。
* **平台名称**: `discord` / `Twitch` / `Twitter`
* **平台ID**: 用户在对应社交平台上的唯一标识符。
* **平台用户名**: 用户在对应社交平台上选择的友好显示名称。
* 示例调用

  ```bash
  curl --request POST 'https://api.ggwp.com/data/v1/ingest' \\
  --header 'x-api-key: api_key' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "类型": "玩家ID关联",
    "user_id": "<id1>",
    "username": "nlxdz",
    "平台名称": "Discord",
    "平台ID": "<id2>",
    "平台用户名": "Avocadorable"
  }'
  ```

## **输出**

* 200 - 操作成功

  ```json
  {
    "status": "成功"
  }
  ```
* 400
  * 错误响应。该事件尚未插入系统。以下情况会抛出此错误：
    * `无效的请求体。应为 JSON 输入`
      * 数据载荷不是 JSON 格式
    * `数据载荷过大`
      * 数据载荷大小超过 1MB
* 403
  * API 密钥无效或缺失。
* 500
  * 错误响应。该事件尚未插入系统。处理请求时服务器发生了一些错误。