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

# 소셜

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

`POST` /users/v1/social

## **설명**

두 플레이어 간의 사회적 관계 변경이나 한 플레이어가 다른 플레이어에 대해 취하는 개별적인 행동(예: 차단)을 보고합니다. 이 정보는 GGWP가 플레이어 신고가 독립적인 출처로부터 온 것인지 평가하고, 집단 괴롭힘 또는 조직적 신고(브리게이딩) 가능 사례를 식별하며, 특정 사건의 평판 영향도를 조정하는 등의 용도로 사용됩니다.

## **매개변수**

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

* **action**: 에서의 사회적 관계 행동 `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:** 행동을 받는 사용자의 고유 식별자.
* **timestamp:** 상태가 업데이트된 시간(에서) *Y*YYYY-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
  * 오류 응답. 이벤트가 시스템에 삽입되지 않았습니다. 요청을 처리하는 동안 서버에 오류가 발생했습니다.

###

###

###