> 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-huo-dong.md).

# 玩家活动

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

`POST` /users/v1/activity 

## **描述**

为了全面展示玩家对社区的贡献，GGWP 会将玩家的活动纳入考虑。GGWP 使用这些信息来校准声誉分数、调整举报者可信度（如适用），并提取可通过玩家资料页查看的相关指标。 

## **参数**

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

* **user\_id**：玩家/用户的 ID
* **login\_time**：格式为的时间戳 *YYYY-MM-DD HH:MM:SS*，UTC 时间
* （可选） **logout\_time:** 以下格式的时间戳 *YYYY-MM-DD HH:MM:SS*，UTC 时间
* （可选） **用户名** ：玩家/用户姓名
* （可选） **来源** ：指示用户所属的来源。
  * 可接受的值：chat、voice、game、discord
  * 默认值：chat
* 示例调用

  ```bash
  curl --request POST 'https://api.ggwp.com/users/v1/activity' \
  --header 'x-api-key: api_key' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "user_id": "<id1>",
    "login_time": "2022-09-10 23:03:27",
    "logout_time": "2022-10-10 23:03:27",
    "username": "<username>",
    "source" : "<source>"
  }'
  ```

## **输出**

* 200 - 操作成功

  ```json
  {
      "success": true
  }
  ```
* 400 - 错误请求
  * 错误响应。用户活动未记录到系统中。当传入的值时会抛出此错误
    * `user_id`
      * 请求体中缺少字段
    * `login_time`
      * 字段不是有效的时间戳
      * 请求体中缺少字段
      * login\_time 不能大于 logout\_time
    * `logout_time`
      * 字段不是有效的时间戳
      * login\_time 不能大于 logout\_time
    * `来源`
      * source 仅接受这些值(chat/voice/game/discord)&#x20;
* 403
  * 无效或缺失的 API 密钥
* 500
  * 错误响应。用户活动未记录到系统中。处理请求时服务器端出现了一些错误