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

# 플레이어 ID 연결

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

`POST` /data/v1/ingest

## **설명**

다양한 관련 플랫폼(예: 게임 내, 디스코드 등)에서 플레이어의 고유 식별자 간의 연결을 보고합니다. 이 정보는 플레이어 수준에서 모든 관련 정보(사건, 신고, 활동 등)를 집계하고 해당 플레이어의 플랫폼 전반에 걸친 평판을 전체적으로 보여주기 위해 사용됩니다.

## **매개변수**

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

* **type**: `player-id-link`
* **user\_id**: 게임 내에서 사용자의 고유 식별자.
* **username**: 게임 내에서 사용자가 선택한 친숙한 표시 이름.
* **platform\_name**: `discord` / `twitch` / `twitter`
* **platform\_id**: 해당 소셜 플랫폼에서 사용자의 고유 식별자.
* **platform\_username**: 해당 소셜 플랫폼에서 사용자가 선택한 친숙한 표시 이름.
* 샘플 호출

  ```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-id-link",
    "user_id": "<id1>",
    "username": "nlxdz",
    "platform_name": "discord",
    "platform_id": "<id2>",
    "platform_username": "Avocadorable"
  }'
  ```

## **출력**

* 200 - 성공적인 작업

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