> 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-pi-liang.md).

# 玩家活动：批量

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

`POST` /users/v1/activity-bulk 

## **描述**

用于从 CSV 文件记录用户活动的 API，会记录 CSV 文件中所有提及用户的登录/登出时间

CSV 文件应遵循以下模板，时间戳使用 UTC

```csv
user_id,login_time,logout_time,username
0000499b-ea03-4517-a6d8-630831daba7a,2025-12-30 07:44:37,2025-12-30 07:54:37,username-abc
```

下方示例图片：

<figure><img src="/files/712d4f18b12db8fa89602d744f6ec005e9cab9d4" alt=""><figcaption></figcaption></figure>

## **重要说明**

* 输入文件应为 CSV 文件
* 输入文件大小不应超过 4 MB

## **参数**

`请求体`:

* CSV 文件
* 示例调用

  ```bash
  curl --location --request POST 'https://api.ggwp.com/users/v1/activity-bulk' \
  --header 'x-api-key: api_key' \
  --header 'Content-Type: text/csv' \
  --data-binary 'File/path/user-activity-data.csv'
  ```

## **输出**

* 200 - 操作成功

  ```json
  {
     “上传成功”
  }
  ```
* 400 - 错误请求
  * 错误响应。用户活动未记录到系统中。当传入的值时会抛出此错误
    * 大小超过 4 MB
    * 文件不是 CSV 格式
* 403
  * 无效或缺失的 API 密钥
* 500
  * 错误响应。用户活动未记录到系统中。处理请求时服务器端出现了一些错误