> 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-7/reputation-score-batch.md).

# 평판 점수: 배치

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

`POST` /users/v1/reputation-score

## **설명**

명성 점수 API는 CSV 형식으로 모든 사용자의 최신 명성 점수를 가져올 수 있게 해줍니다. 파일은 다운로드 가능한 URL로 제공되며, 해당 URL은 이메일이나 웹훅 구독을 통해 또는 둘 다를 통해 반환됩니다. 사용자 ID, 사용자 이름 및 현재 명성 점수 외에도 CSV에는 각 사용자에 대한 긍정적, 부정적 및 참여 지표가 포함됩니다. 명성 점수는 게임에서 사용자의 행동을 기반으로 산출되며 150에서 850 사이의 값을 가지며, 값이 낮을수록 더 독성이 있거나 부정적인 행동을 나타냅니다.

참고: 

1. CSV URL은 생성 시점으로부터 30분 동안 유효합니다.
2. 사용자 수가 1,000,000명을 초과하는 경우 데이터는 여러 CSV 파일로 분할됩니다.

## **매개변수**

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

* **mode**: CSV 전달 방식. 지원되는 값: `all`, `email`, `webhook`
  * 선택 시 `webhook`, 반드시 다음을 구성해야 합니다 [Webhook](/kr/webhooks.md) 시스템 및 다음에 구독하십시오 [Player Reputation Score Batch 이벤트](https://docs.ggwp.com/kr/api-7/pages/bfafcf6045df9435008fc1b2294984eb324bcf63#id-6.-player-reputation-score-batch)
* (선택 사항) **email**: CSV 전달용 이메일 ID, mode가 일때만 적용됩니다 `all`/`email`
* (선택 사항) **score\_range:** 입력 범위 내에 있는 명성 점수를 가진 모든 플레이어를 반환합니다. 유효한 입력 범위는 150에서 850 사이입니다.
  * 예시: 
    * `"score_range": "bw:150-850"` 
    * `"score_range": "bw:150-250"` 
    * `"score_range": "bw:550-850"`
* (선택 사항) **sanction\_status** : 플레이어의 제재 상태를 필터링합니다. 이 매개변수는 여러 값을 허용할 수 있습니다. 여러 값이 전달된 경우 API는 값들 사이에 OR 연산자를 적용합니다.
  * 지원되는 값:
    * `chat_active`
    * `chat_muted`
    * `chat_session_muted`
    * `discord_active`
    * `discord_muted`
    * `game_active`
    * `game_muted`
  * 예시: 
    * `"sanction_status": "in:'chat_active','game_active'"` 

샘플 호출:

```bash
curl --request POST 'https://api.ggwp.com/users/v1/reputation-score' \
--header 'x-api-key: api_key' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mode": "email",
    "email": "abc@xyz.com",
    "score_range": "bw:150-850",
    "sanction_status": "in:'\''chat_muted'\'','\''game_muted'\''"
}'
```

## **출력**

* 200 - 성공적인 작업

```json
{"success": true}
```

* 403
  * 잘못되었거나 누락된 API 키
* 404
  * UserInvalid 또는 누락된 'mode' - mode가 제공되지 않았을 때
  * 이메일 ID 누락 - 이메일 ID가 제공되지 않았을 때
  * 웹훅 이벤트 미구독 - reputation-score에 대한 웹훅이 구독되지 않았을 때.
* 500
  * 오류 응답. 평판 점수를 가져올 수 없습니다

#### 참고:

* 웹훅이 전달 방식으로 선택된 경우, 웹훅 응답은 다음 형식을 가집니다:

```
{
  "type": "player-reputation-batch-export",
  "event_id": "<event_id>",
  "created_at": "2024-10-06 16:30:09",
  "data": {
    "csv_urls": [
      "csv_url_1",
      "csv_url_2"
    ]
  }
}
```