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

# API 문서: 문맥 정보

## **소개**

플레이어의 행동과 커뮤니티에 대한 기여를 가장 정확하고 완전하게 파악하기 위해 GGWP는 다양한 게임 맥락 입력을 수집하여 이를 사용해 신고를 검증하고 행동 수정자를 적용하며 전체 플레이어 기반의 평판 시스템을 보정합니다. GGWP는 게임에서 관련 데이터 요소를 공유하고 통합하는 데 사용할 수 있는 API를 제공합니다.

## 인증

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

`x-api-key: <API_KEY>`

각 API 키는:

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

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

## API 키 사용 방법

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

```bash
curl --request POST 'https://api.ggwp.com/data/v1/ingest' \
--header 'x-api-key: api_key' \
--header 'Content-Type: application/json' \
--data-raw '{
  "type": "social",
  "action": "friend",
  "user1_id": "<id1>",
  "user2_id": "<id2>",
  "timestamp": "2022-01-25 09:44:00"
}'
```

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