> 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/she-jiao.md).

# 社交

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

`POST` /users/v1/social

## **描述**

报告两个玩家之间社交关系的任何变化，或某个玩家对另一位玩家采取的任何单独操作（例如：拉黑）。GGWP 使用这些信息来评估玩家举报是否来自独立来源，识别可能的刷屏围攻（brigading）或欺凌案例，并调整某些事件对信誉的影响，等等。

## **参数**

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

* **操作**: 来自的社交关系操作 `user_action_id` to `user_recipient_id`。两个用户之间的状态将相应更新。支持的值： `好友`, `取消好友`, `关注`, `取消关注`, `拉黑`，或 `解除拉黑：`
  * `好友` → 在 user\_action\_id 和 user\_recipient\_id 之间添加双向好友关系链接。两个用户的顺序无关紧要
  * `取消好友` → 删除 user\_action\_id 和 user\_recipient\_id 之间的双向好友关系链接。两个用户的顺序无关紧要
  * `关注` → 在 user\_action\_id 到 user\_recipient\_id 之间添加单向关注链接
  * `取消关注` → 删除从 user\_action\_id 到 user\_recipient\_id 的单向关注链接
  * `拉黑` → 在 user\_action\_id 到 user\_recipient\_id 之间添加单向拉黑链接
  * `解除拉黑` → 删除从 user\_action\_id 到 user\_recipient\_id 的单向拉黑链接
* **user\_action\_id**：触发该操作的用户的唯一标识符。
* **user\_recipient\_id:** 接收该操作的用户的唯一标识符。
* **时间戳：** 状态更新时间为 *Y*YY-MM-DD HH:MM:SS.SSS 或 YYYY-MM-DD HH:MM:SS 格式，UTC 时间。若为空，则使用服务器端 UTC 时间戳代替。
* 示例调用

  ```bash
  curl --request POST 'https://api.ggwp.com/users/v1/social' \
  --header 'x-api-key: api_key' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "action": "friend",
    "user_action_id": "<id1>",
    "user_recipient_id": "<id2>",
    "timestamp": "2022-01-25 09:44:00"
  }'
  ```

## **输出**

* 200 - 操作成功

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

###

###

###