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

# 플레이어 활동

\[ 기본 URL: `api.ggwp.com`]

`POST` /users/v1/activity 

## **설명**

플레이어의 커뮤니티 기여도를 전체적으로 파악하기 위해 GGWP는 플레이어의 활동을 고려합니다. 이 정보는 평판 점수를 보정하고(해당되는 경우) 신고자 신뢰도를 조정하며 플레이어 프로필 페이지를 통해 소비될 수 있는 관련 지표를 도출하는 데 사용됩니다. 

## **매개변수**

`본문`: 다음 필드를 포함하는 사전(Dictionary):

* **user\_id**: 플레이어/사용자의 ID
* **login\_time**: 형식의 타임스탬프 *YYYY-MM-DD HH:MM:SS*, UTC 기준
* (선택 사항) **logout\_time:** 형식의 타임스탬프 *YYYY-MM-DD HH:MM:SS*, UTC 기준
* (선택 사항) **username** : 플레이어/사용자의 이름
* (선택 사항) **source** : 사용자가 속한 출처를 나타냅니다.
  * 허용 값 : 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`
      * source는 다음 값만 허용합니다(chat/voice/game/discord)&#x20;
* 403
  * 잘못되었거나 누락된 API 키
* 500
  * 오류 응답입니다. 사용자 활동이 시스템에 기록되지 않았습니다. 요청을 처리하는 동안 서버에서 오류가 발생했습니다