# Introduction

## Important Notes

{% hint style="info" %}
All endpoints require your dsc.gg API token in the Authorization header. More on that under the "Endpoints" section.
{% endhint %}

## API Wrappers:

**Javascript wrapper:** [**https://npm.im/dsc.js**](https://npm.im/dsc.js)\
\
**Python wrapper:** [**https://pypi.org/project/dsc.py**](https://pypi.org/project/dsc.py)\
\
**Java wrapper:** [**https://github.com/dsc-gg/dsc.java**](https://github.com/dsc-gg/dsc.java)

## FAQ

**Where can I find the API endpoints?** \
Find them here: [https://docs.dsc.gg/endpoints](https://docs.dsc.gg/endpoints-v2)

**I got a 429! What can I do?** \
This means you have hit the rate limit. If you need an extended rate limit, refer to our whitelisting program.

**Are there any requirements for whitelisting?** \
We don't have a set "requirement" of anything to get whitelisted. We will whitelist you if you provide a valid reason why you need to get whitelisted, if you follow all our guidelines, and if your application is fairly large (smaller ones shouldn't need whitelisting)

**How do I get whitelisted?** \
You can apply by pinging a mod in #support or #api-discussion for instructions on what you need to provide to us. We won't be whitelisting random applications without a good reason why whitelisting is needed.

**I can't access the endpoint \[Insert endpoint here]!** \
Chances are this means the endpoint is for whitelisted apps only. Refer to the "How do I get whitelisted?" question for more information on this.

**\[Insert something] doesn't make sense!** \
If you need help with something, refer to our quick start guide or ask for help in #api-discussion.

**I need help with something not listed here!** \
For other questions or general discussion, use #api-discussion

## **Getting Started**

Step 1: Registering your application\
\
**Step 1: Registering your application** \
1\) Head over to <https://dsc.gg/developers/dashboard> and click on the "Create New" button \
2\) Fill out all the required fields with information on the app you want to use the dsc.gg API with \
3\) Hit "Create App" and make note of the generated API key

**Step 2: Finding your library** \
We have a few options for API libraries you can use. You can choose one of the below or use the raw API.

Javascript Library: Dsc.js - <https://npm.im/dsc.js> \
Python Library: Dsc.py - <https://pypi.org/project/dsc.py> \
Java Library: Dsc.java - <https://github.com/dsc-gg/dsc.java>

**Step 3: Start developing** \
Depending on the API library you choose, you can learn how to use it via the corresponding docs. \
\&#xNAN;*If you are directly using our API, you can continue with the raw endpoints at:* <https://docs.dsc.gg/endpoints>.


---

# 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://docs.dsc.gg/master.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.