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

# 플레이어 진행

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

`POST` /data/v1/ingest

## **설명**

특정 시점에서 플레이어의 실력 수준을 반영하는 관련 지표를 보고합니다. 이 정보는 사건에 심각도 수정을 적용하고 플레이어 경험을 기반으로 평판 및 신뢰도 점수를 정규화하며 GGWP의 중재 도구에서 사건이나 플레이어를 검토할 때 추가 문맥을 제공하는 데 사용됩니다.

이전 섹션에서 설명한 매치 요약 통계와 유사하게 진행도 지표는 게임 장르에 따라 크게 달라질 수 있으므로 동일한 지침과 예제가 적용됩니다. 주요 차이점은 플레이어 진행도는 전체 플레이 시간에 걸친 누적 플레이어 지표를 본다는 것입니다.

## **매개변수**

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

* **type**: `player-progression`
* **user\_id**: 사용자의 고유 식별자.
* **username**: 표시용 친숙한 이름.
* **date\_joined**: 계정 생성 날짜(의). *YYYY-MM-DD HH:MM:SS* 형식, UTC 기준.
* **total\_time\_played**: 계정 생성 이후 사용자가 플레이한 누적 시간(분 단위).
* **total\_sessions\_played**: 계정 생성 이후 사용자가 플레이한 총 세션 수.
* **user\_level**: 누적 평생 레벨.
* **progression\_stats**: 관련된 긍정적, 부정적 또는 중립적 통계의 평생 값(매치 요약 섹션의 표를 참조하십시오).
* 샘플 호출

  ```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-progression",
    "user_id": "<id1>",
    "username": "SweetPoison",
    "date_joined": "2023-02-24 12:15:07",
    "total_time_played": 805,
    "total_sessions_played": 67,
    "user_level": "75",
    "progression_stats": {
      "positive_stats": {
        "wins": 169,
        "kills": 236,
        "headshots": 54,
        "assists": 295
      },
      "negative_stats": {
        "losses": 198,
        "deaths": 502
      },
      "neutral_stats": {
      }		
    }
  }'
  ```

## **출력**

* 200 - 성공적인 작업

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