> 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-she-zhi.md).

# 玩家设置

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

`POST` /data/v1/ingest

## **描述**

报告游戏会话期间所选的任何玩家设置，这些设置用于描述玩家对毒性的容忍程度。这包括禁用聊天、将其他玩家静音、选择过滤灵敏度或创建自定义黑名单等。此信息用于为事件应用严重程度修饰符，并在 GGWP 的审核工具中审查事件或玩家时提供额外上下文。

## **参数**

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

* **类型**: `玩家设置`
* **user\_id**: 玩家唯一标识符。
* **session\_id**: 会话的唯一标识符。
* **操作**: `关闭聊天` / `禁言玩家` / `过滤灵敏度` / `自定义黑名单`
* **时间戳：** 操作执行的时间，格式为 *YYYY-MM-DD HH:MM:SS* 格式，采用 UTC 时间。如果为空，则使用服务器端 UTC 时间戳代替。
* **附加详情**: 包含与所执行操作相关的附加信息的字典。示例如下：
  * **目标用户 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 '{
    "type": "玩家设置",
    "user_id": "<id1>",
    "session_id": "<sessionID1>",
    "action": "禁言玩家",
    "timestamp": "2022-01-25 09:44:00",
    "additional_details": {
      "target_user_id": "<id2>"
    }
  }'
  ```
* 示例调用（自定义黑名单）&#x20;

  ```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>",
    "session_id": "<sessionID1>",
    "action": "自定义黑名单",
    "timestamp": "2022-01-25 09:44:00",
    "additional_details": {
      "terms": ["incel", "gey", "simp", "chad"]
    }
  }'
  ```

## **输出**

* 200 - 操作成功

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