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

# 표준 패키지

## 인증

GGWP는 API 키를 사용하여 승인된 사용자에게 아래에 나열된 모든 API 엔드포인트에 대한 सुरक्षित한 접근을 제공합니다. 모든 요청은 제공된 API 키와 함께 다음 HTTP 헤더를 포함해야 합니다:

`x-api-key: <API_KEY>`

각 API 키는:

* 귀하의 플랫폼/게임을 고유하게 식별합니다
* 이 문서에 나열된 모든 API에 대한 API 접근 권한을 부여합니다
* 초당 요청 수에 대한 특정 제한과, 월 단위로 요청할 수 있는 횟수에 대한 가능한 할당량이 있습니다
* 비밀로 유지해야 하며 권한이 없는 게임/사용자와 공유해서는 안 됩니다
* 한 번 분실되면 새 키를 다시 생성해야 합니다

API 키 발급과 게임에 필요한 올바른 속도 제한 설정을 위해 GGWP 계정 담당자에게 문의해 주세요.

## API 키 사용 방법

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

```bash
curl --request POST 'https://api.ggwp.com/chat/v3/message' \
--header 'x-api-key: api_key' \
--header 'Content-Type: application/json' \
--data-raw '{
          "session_id": "match_7765",
          "message": "어디에나 빌어먹을 장애인들",
          "user_id": "user989",
          "username": "nlxdz",
          "timestamp": "2022-06-02 16:49:02"
}'
```

잘못된 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
```