> 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/jp/apidokyumento-kontekisuto/pureiyakutibiti.md).

# プレイヤーアクティビティ

\[ ベース URL: `api.ggwp.com`]

`POST` /users/v1/activity 

## **説明**

プレイヤーのコミュニティへの貢献を総合的に把握するため、GGWP はプレイヤーのアクティビティを考慮します。この情報は、GGWP が評判スコアを調整し、（該当する場合は）通報者の信頼度を調整し、プレイヤーのプロフィールページから参照できる関連指標を算出するために使用されます。 

## **パラメータ**

`ボディ`: 次のフィールドを含む辞書:

* **user\_id**: プレイヤー/ユーザーのID
* **ログイン時刻**: 形式のタイムスタンプ *YYYY-MM-DD HH:MM:SS*、UTCで
* （任意） **ログアウト時刻:** 次の形式のタイムスタンプ *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 は logout\_time より大きくできません
    * `ログアウト時刻`
      * フィールドは有効なタイムスタンプではありません
      * login\_time は logout\_time より大きくできません
    * `source`
      * source は次の値のみ受け付けます(chat/voice/game/discord)&#x20;
* 403
  * 無効な API キー、または API キーがありません
* 500
  * エラーレスポンス。ユーザーのアクティビティはシステムに記録されていません。リクエストの処理中にサーバー側で何らかのエラーが発生しました