# Apply Your Test Key

* RPGGO Public API is in currently under **alpha phase** and do not open to auto-public application. 
* If you want to try it for personal demo, following below instruction to self-service your API key, but those of keys have rate limit. 
* If you need a key for a commercial use case(without rate limit), please submit an application form via [here](https://forms.gle/sw9kqPQNfBDcnya6A), or send an email to <mark style="background-color:yellow;"><dev@rpggo.ai></mark> to get an prod API key

### Get your API key

Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error.

The good news is, we are currently openning the api key management for everyone. You can

1. go to <https://rpggo.ai/>
2. Log in with your Google or Discord account. Click your avatar in the up-right corner and find the "Manage Your API Key" in the submenu. Copy the API key.

<figure><img src="https://1241690067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FChXuEllR7kvvuUM9K1Fi%2Fuploads%2FgcIdtcKeILKGh10InfOq%2Fscreenshot-20241219-083436.png?alt=media&#x26;token=14618069-7262-430f-93b1-d8f574d6fa6f" alt=""><figcaption></figcaption></figure>

### Use API key to authenticate

For users who create multiple apps, you should pass a header to specify which App is used for an API request. Future usage from these API requests will count against the specified App's subscription quota.

{% hint style="info" %}
**Remember that your API key is a secret!**  Do not share it with others or expose it in any client-side code (browsers, apps). Production requests must be routed through your own backend server where your API key can be securely loaded from an environment variable or key management service.
{% endhint %}

All API requests should include API key in  HTTP header as follows:

```
Authorization: Bearer YOUR_RPGGO_API_KEY
```

Example curl command:

```bash
curl https://api.rpggo.ai/open/game/gamelist \
  -H "Authorization: Bearer $YOUR_RPGGO_API_KEY" 
```

RPGGO server will verify permissions by the **`Authorization`** and several other parameters. If an incorrect key is used the API will return a 401 HTTP error.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.rpggo.ai/dev-docs/support/apply-your-test-key.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.