> 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/bi-sai-xin-xi.md).

# 比赛信息

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

`POST` /data/v1/ingest

## **描述**

报告任何用于定义新比赛事件的相关信息。这些信息用于对事件应用严重性修饰符、随时间跟踪玩家队伍，并在使用 GGWP 的审核工具查看事件或玩家时提供额外上下文。

## **参数**

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

* **类型**: `match-info`
* **session\_id**: 比赛的唯一标识符。
* **session\_type**：描述比赛类型或模式的字符串。示例： `休闲`, `竞技`, `自定义`.
* **players**：所有玩家参与者和队伍的列表。相关项目包括：
  * **user\_id**：用户的唯一标识符。
  * **用户名**：友好显示名称。
  * **team\_id**：队伍标识符。
  * **party\_id**：用于关联一起排队的玩家队伍的标识符。
  * **character\_name**：玩家所选角色的名称。
  * **用户等级**：当前玩家等级。
* 示例调用

  ```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": "match-info",
    "session_id": "<sessionID1>",
    "session_type": "竞技",
    "players": [
      {
        "user_id": "<id1>",
        "username": "nlxdz",
        "team_id": "1",
        "party_id": "1",
        "character_name": "Dracarys",
        "user_level": "50"
      },
      {
        "user_id" "<id2>",
        ...
      }
    ]
  }'
  ```

## **输出**

* 200 - 操作成功

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