> ## Documentation Index
> Fetch the complete documentation index at: https://docs.discord.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Use with Discord APIs

> Combine Discord Social SDK with Discord's REST APIs for enhanced functionality.

## Overview

The Discord Social SDK provides client-side functionality for integrating Discord social features into your game. However, if you use a game backend, you should interact with Discord's HTTP APIs for server-side operations when possible.

### Prerequisites

Before you begin, make sure you have:

* A Discord application created in the Developer Portal
* Access to your application's bot token
* Required OAuth2 scopes configured

***

## Authentication Types

### Bot Token Authentication

For server-to-server communication:

```bash theme={"system"}
curl -X GET https://discord.com/api/v10/users/@me \
  -H "Authorization: Bot YOUR_BOT_TOKEN"
```

> [!NOTE]
>
> Always prefix your bot token with `Bot ` in the Authorization header!

### Bearer Token Authentication

For authenticated user actions:

```bash theme={"system"}
curl -X GET https://discord.com/api/v10/users/@me \
  -H "Authorization: Bearer USER_ACCESS_TOKEN"
```

## Common API Operations

### OAuth2 Token Exchange

Exchange an authorization code for an access token:

```python theme={"system"}
# filepath: /your/backend/auth.py
import requests

def exchange_code(code, redirect_uri):
    data = {
        'client_id': 'YOUR_CLIENT_ID',
        'client_secret': 'YOUR_CLIENT_SECRET',
        'grant_type': 'authorization_code',
        'code': code,
        'redirect_uri': redirect_uri
    }
    
    response = requests.post('https://discord.com/api/v10/oauth2/token', data=data)
    return response.json()
```

### User Information

Get information about the authenticated user:

```python theme={"system"}
def get_user_info(access_token):
    headers = {'Authorization': f'Bearer {access_token}'}
    response = requests.get('https://discord.com/api/v10/users/@me', headers=headers)
    return response.json()
```

***

## Using the OpenAPI Specification

You can use the [Discord OpenAPI Spec](https://github.com/discord/discord-api-spec) to generate a client in your preferred backend language to make it easier to call the various APIs. A good tool for that is [https://openapi-generator.tech/](https://openapi-generator.tech/).

In python for example, that might look like this:

```python theme={"system"}
import openapi_client
import os
from pprint import pprint
 
configuration = openapi_client.Configuration(host = "https://discord.com/api/v10")
configuration.api_key['BotToken'] = 'Bot ' + os.environ["API_KEY"]
with openapi_client.ApiClient(configuration) as api_client:
    api_instance = openapi_client.DefaultApi(api_client)
 
    request = openapi_client.CreateLobbyRequest()
    request.metadata={'foo':'bar'}
    pprint(api_instance.create_lobby(request))
```

***

## Best Practices

1. Token Security
   * Never expose bot tokens in client-side code
   * Store tokens securely
2. Rate Limiting
   * Respect Discord's [rate limits](https://docs.discord.com/developers/topics/rate-limits.md)
   * Implement exponential backoff
   * Cache responses when appropriate
3. Error Handling
   * Handle HTTP errors gracefully
   * Implement retry logic for transient failures
   * Log API errors for debugging

***

## Next Steps

Now that you've set up Rich Presence, you might want to explore:

> [card] [Managing Game Invites](https://docs.discord.com/developers/discord-social-sdk/development-guides/managing-game-invites.md)
>
> Allow players to invite friends to join their game session or party.

> [card] [Managing Lobbies](https://docs.discord.com/developers/discord-social-sdk/development-guides/managing-lobbies.md)
>
> Bring players together in a shared lobby with invites, text chat, and voice comms.

> [card] [Design Guidelines for Rich Presence](https://docs.discord.com/developers/discord-social-sdk/design-guidelines/status-rich-presence.md)
>
> Best practices for Rich Presence UI/UX.

Need help? Join the [Discord Developers Server](https://discord.gg/discord-developers) and share questions in the `#social-sdk-dev-help` channel for support from the community.

If you encounter a bug while working with the Social SDK, please report it here:  [https://dis.gd/social-sdk-bug-report](https://dis.gd/social-sdk-bug-report)

***

## Change Log

| Date | Changes |
| - | - |
| March 17, 2025 | Initial Release |
