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

# 玩家消费

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

`POST` /users/v1/player-spend

## **描述**

报告个人玩家在游戏内购买上花费的任何真实货币金额。此信息用于在 GGWP 的审核工作流面板中提供额外上下文，以便社区管理员和审核团队在评估玩家行为时能够做出尽可能最佳的决策。

## **参数**

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

* **user\_id**: 玩家唯一标识符。
* **(可选) 平台：** 购买发生的平台（例如 Xbox、PlayStation、Android 等）
* **货币**: 所使用的货币类型（例如：“USD”、“EUR”、“JPY”、“BTC”等）
* **交易金额**: 已完成交易的数值。
* **物品类别**: `游戏内购买` / `战斗通行证` / `外观`.
* **物品 ID**: 所购买物品类型的标识符。
* **(可选) 终身消费**: 玩家整个生命周期内的累计消费总额。
* **(可选) 时间戳：** 交易执行时间，单位为 *YYYY-MM-DD HH:MM:SS* 格式，采用 UTC 时间。如果为空，则使用服务器端 UTC 时间戳代替。
* 示例调用

  ```bash
  curl --request POST 'https://api.ggwp.com/users/v1/player-spend' \
  --header 'x-api-key: api_key' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "user_id": "<id1>",
    "platform": "android",
    "currency": "USD",
    "transaction_amount": 6.50,
    "item_category": "cosmetic",
    "item_id": "skin",
    "lifetime_spend": 124.75,
    "timestamp": "2022-01-25 09:44:00"
  }'
  ```

## **输出**

* 200 - 操作成功

  ```json
  {
    "status": "成功"
  }
  ```
* 400
  * 错误响应。该事件尚未插入系统。以下情况会抛出此错误：
    * `无效的请求体。应为 JSON 输入`
      * 数据载荷不是 JSON 格式
    * `数据载荷过大`
      * 数据载荷大小超过 1MB
* 403
  * API 密钥无效或缺失。
* 500
  * 错误响应。该事件尚未插入系统。处理请求时服务器发生了一些错误。