> 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/jp/apidokyumento-chat/pakkji.md).

# 標準パッケージ

## 認証

GGWPでは、APIキーを使用して、認可されたユーザーに以下に記載されたすべてのAPIエンドポイントへの安全なアクセスを提供します。すべてのリクエストでは、発行されたAPIキーとともに、次のHTTPヘッダーを送信する必要があります。

`x-api-key: <API_KEY>`

各APIキーは次のとおりです。

* あなたのプラットフォーム／ゲームを一意に識別します
* このドキュメントに記載されているすべてのAPIへのアクセスを提供します
* 1秒あたりに実行できるリクエスト数に対する特定のレート制限があり、さらに月単位で実行できるリクエスト数の上限クォータが設定されている場合があります
* 秘密として保持し、許可されていないゲーム／ユーザーと共有しないでください
* 紛失した場合は、新しいキーを再生成する必要があります

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
```