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

# 플레이어 설정

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

`POST` /data/v1/ingest

## **설명**

게임 세션 중 플레이어의 독성 허용 수준을 설명하는 플레이어 설정을 보고합니다. 여기에는 채팅 비활성화, 다른 플레이어 음소거, 필터 민감도 선택 또는 맞춤 차단 목록 생성과 같은 항목이 포함됩니다. 이 정보는 사건에 심각도 수정을 적용하고 GGWP의 중재 도구에서 사건이나 플레이어를 검토할 때 추가 컨텍스트를 제공하는 데 사용됩니다.

## **매개변수**

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

* **type**: `player-settings`
* **user\_id**: 플레이어의 고유 식별자.
* **session\_id**: 세션의 고유 식별자.
* **action**: `chat-disable` / `player-mute` / `filter-sensitivity` / `custom-blocklist`
* **timestamp:** 조치가 실행된 시간(다음 형식으로) *YYYY-MM-DD HH:MM:SS* 형식, UTC 기준. 비어 있으면 서버 측 UTC 타임스탬프가 대신 사용됩니다.
* **additional\_details**: 취해진 조치와 관련된 추가 정보를 포함하는 딕셔너리. 예시는 다음과 같습니다:
  * **target\_user\_id**: 대상 플레이어의 고유 식별자(조치가 적용될 때). `player-mute`)
  * **filter\_settings**: 선택된 필터 수준(조치가 적용될 때). `filter-sensitivity`)
  * **terms**: 맞춤 차단 용어 목록(조치가 적용될 때). `custom-blocklist`)
* 샘플 호출 (플레이어 음소거)

  ```bash
  curl --request POST 'https://api.ggwp.com/data/v1/ingest' \
  --header 'x-api-key: api_key' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "type": "player-settings",
    "user_id": "<id1>",
    "session_id": "<sessionID1>",
    "action": "player-mute",
    "timestamp": "2022-01-25 09:44:00",
    "additional_details": {
      "target_user_id": "<id2>"
    }
  }'
  ```
* 샘플 호출 (맞춤 차단 목록)&#x20;

  ```bash
  curl --request POST 'https://api.ggwp.com/data/v1/ingest' \
  --header 'x-api-key: api_key' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "type": "player-settings",
    "user_id": "<id1>",
    "session_id": "<sessionID1>",
    "action": "custom-blocklist",
    "timestamp": "2022-01-25 09:44:00",
    "additional_details": {
      "terms": ["incel", "gey", "simp", "chad"]
    }
  }'
  ```

## **출력**

* 200 - 성공적인 작업

  ```json
  {
    "status": "success"
  }
  ```
* 400
  * 오류 응답. 이벤트가 시스템에 삽입되지 않았습니다. 다음 경우에 이 오류가 발생합니다:
    * `잘못된 본문. JSON 입력을 예상했습니다`
      * 데이터 페이로드가 JSON 형식이 아닙니다
    * `데이터 페이로드가 너무 큽니다`
      * 데이터 페이로드가 1MB를 초과합니다
* 403
  * 유효하지 않거나 누락된 API 키입니다.
* 500
  * 오류 응답. 이벤트가 시스템에 삽입되지 않았습니다. 요청을 처리하는 동안 서버에 오류가 발생했습니다.