> 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-jin-du.md).

# 玩家进度

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

`POST` /data/v1/ingest

## **描述**

报告任何相关指标，以反映玩家在某一时刻的技能水平。此信息用于对事件应用严重程度修正，根据玩家经验对声誉和可信度分数进行标准化，并在 GGWP 的审核工具中查看事件或玩家时提供额外上下文。

与上一节所述的对局摘要统计类似，进度指标会因游戏类型而有很大差异，因此此处同样适用相同的指南和示例。主要区别在于，玩家进度关注的是玩家在整个游戏时长内的累计指标。

## **参数**

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

* **类型**: `玩家进度`
* **user\_id**：用户的唯一标识符。
* **用户名**：友好显示名称。
* **加入日期**：账户创建日期为 *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": "玩家进度",
    "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": "成功"
  }
  ```
* 400
  * 错误响应。该事件尚未插入系统。以下情况会抛出此错误：
    * `无效的请求体。应为 JSON 输入`
      * 数据载荷不是 JSON 格式
    * `数据载荷过大`
      * 数据载荷大小超过 1MB
* 403
  * API 密钥无效或缺失。
* 500
  * 错误响应。该事件尚未插入系统。处理请求时服务器发生了一些错误。