> 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/kr/api-6/player-activity-batch.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/4e22169b9309c9c36df30ed3d785daa9c0c5e066" alt=""><figcaption></figcaption></figure>

## **중요 참고사항**

* 입력 파일은 CSV 파일이어야 합니다
* 입력 파일의 크기는 4MB를 초과해서는 안 됩니다

## **매개변수**

`본문`:

* 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 - 잘못된 요청
  * 오류 응답입니다. 사용자 활동이 시스템에 기록되지 않았습니다. 이는 전달된 값이 다음과 같을 때 발생합니다
    * 크기가 4MB를 초과함
    * CSV 형식의 파일이 아님
* 403
  * 잘못되었거나 누락된 API 키
* 500
  * 오류 응답입니다. 사용자 활동이 시스템에 기록되지 않았습니다. 요청을 처리하는 동안 서버에서 오류가 발생했습니다