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

# API 문서: 평판

## **소개**

GGWP는 평판 점수를 검색하는 데 사용할 수 있는 일련의 API를 제공합니다.

## 인증

GGWP는 API 키를 사용하여 승인된 사용자에게 아래에 나열된 모든 API 엔드포인트에 대한 보안 액세스를 부여합니다. 모든 요청은 프로비저닝된 API 키와 함께 다음 HTTP 헤더를 제공해야 합니다:

`x-api-key: <API_KEY>`

각 API 키는:

* 귀하의 게임을 고유하게 식별합니다
* 이 문서에 나열된 모든 API에 대한 액세스를 제공합니다
* 초당 요청 수에 대한 특정 속도 제한과 월간 기준으로 수행할 수 있는 요청 수의 할당량이 있을 수 있습니다
* 비밀로 유지되어야 하며 승인되지 않은 게임/사용자와 공유해서는 안 됩니다
* 한 번 분실되면 새 키를 다시 생성해야 합니다

API 키 프로비저닝 및 귀하의 게임에 필요한 적절한 속도 제한 설정을 위해 GGWP 계정 담당자에게 문의하시기 바랍니다.

## API 키 사용 방법

다음은 유효한 API 키를 사용하여 프로덕션 API 엔드포인트를 호출하는 예입니다(이 예에서는 키가 가려져 있습니다):

```bash
curl --request GET 'https://api.ggwp.com/users/<user_id>/v1/reputation-score' \
--header 'x-api-key: api_key' \
--header 'Content-Type: application/json'
```

유효하지 않은 API 키는 `403` 응답 코드를 반환합니다. 아래는 유효하지 않은 API 키로 받은 예시 응답입니다:

```bash
< HTTP/2 403
< date: Thu, 18 Nov 2021 21:28:27 GMT
< content-type: application/json
< content-length: 23
< x-amzn-requestid: f4361ec6-71bc-478f-98cd-da0fe9df829b
< x-amzn-errortype: ForbiddenException
< x-amz-apigw-id: JBPLRHGjPHcFdbg=
<
* Connection #0 to host api.ggwp.com left intact
{"message": "Forbidden"}* Closing connection 0
```