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

# 표준 패키지

## 인증

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

`x-api-key: <API_KEY>`

각 API 키:

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

게임에 필요한 올바른 속도 제한을 설정하고 API 키를 발급받으려면 GGWP 계정 담당자에게 문의해 주세요.

## API 키 사용 방법

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

```bash
curl --location --request POST 'https://api.ggwp.com/voice/v1/ingest' \
--header 'file-name: 20230620_john123.wav' \
--header 'user-id: player10' \
--header 'username: john123' \
--header 'session-id: match_unranked_20230620_12345' \
--header 'audio-time: 2023-06-20 10:24:23' \
--header 'x-api-key: api_key' \
--data-binary '@/location/to/20230620_john123.wav'
```

유효하지 않은 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
```