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

# 매치 정보

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

`POST` /data/v1/ingest

## **설명**

새로운 경기 이벤트를 정의하는 관련 정보를 보고합니다. 이 정보는 사건에 심각도 수정을 적용하고, 시간에 걸쳐 플레이어 파티를 추적하며, GGWP의 중재 도구에서 사건이나 플레이어를 검토할 때 추가적인 문맥을 제공하는 데 사용됩니다.

## **매개변수**

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

* **type**: `match-info`
* **session\_id**: 경기의 고유 식별자.
* **세션\_유형**: 매치 유형 또는 모드를 설명하는 문자열. 예: `캐주얼`, `경쟁전`, `커스텀`.
* **플레이어**: 모든 플레이어 참가자 및 팀의 목록입니다. 관련 항목으로는 다음이 있을 수 있습니다:
  * **user\_id**: 사용자의 고유 식별자.
  * **username**: 표시용 친숙한 이름.
  * **팀\_id**: 팀 식별자.
  * **파티\_id**: 함께 큐를 넣는 플레이어 파티를 연결하는 식별자.
  * **캐릭터\_이름**: 플레이어가 선택한 캐릭터의 이름.
  * **user\_level**: 현재 플레이어 레벨.
* 샘플 호출

  ```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": "match-info",
    "session_id": "<sessionID1>",
    "session_type": "competitive",
    "players": [
      {
        "user_id": "<id1>",
        "username": "nlxdz",
        "team_id": "1",
        "party_id": "1",
        "character_name": "Dracarys",
        "user_level": "50"
      },
      {
        "user_id" "<id2>",
        ...
      }
    ]
  }'
  ```

## **출력**

* 200 - 성공적인 작업

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