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

# Standard Package

## Authentication

GGWP uses API keys to grant authorized users secure access to all of the API endpoints listed below. All requests must supply the following HTTP header along with the API key provisioned:

`x-api-key: <API_KEY>`

Each API key:

* Uniquely identifies your platform/game
* Gives API access to all APIs listed in this document
* Has a specific rate limit on the number of requests that can be made per second as well as a possible set quota of the number of requests that can be made on a month to month basis
* Should be kept a secret and should not be shared with any unauthorized games / users
* Once lost, a new key will have to be regenerated

Please contact your GGWP Account Executive for provisioning an API key as well as setting the correct rate limits required for your game.

## How to use your API key

The following is an example invocation of the production API endpoint using a valid API key (key is redacted in this example):

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

An invalid API key will return a `403` return code. Below is an example response with an invalid API key:

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