> 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-2/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/image/v1/moderate' \\
  --header 'x-api-key: <API_KEY>' \\
  --header 'x-api-config: <BASE64_CONFIG>' \\
  --header 'x-api-processing-mode: quality' \\
  -F "file=@/path/to/example.jpeg" \\
  -F "file_name=avatar123.jpeg" \\
  -F "user_id=user989"
```

유효하지 않은 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=
<
* 연결 #0이 api.ggwp.com 호스트에 대해 그대로 유지되었습니다
{"message":"금지됨"}* 연결 0을 닫는 중
```