OAuth2 Setup

This guide explains how to perform a basic OAuth2 flow with disagreement.

Generate the authorization URL:

from disagreement.oauth import build_authorization_url

url = build_authorization_url(
    client_id="YOUR_CLIENT_ID",
    redirect_uri="https://your.app/callback",
    scope=["identify"],
)
print(url)

After the user authorizes your application and you receive a code, exchange it for a token:

import aiohttp
from disagreement.oauth import exchange_code_for_token

async def get_token(code: str):
    return await exchange_code_for_token(
        client_id="YOUR_CLIENT_ID",
        client_secret="YOUR_CLIENT_SECRET",
        code=code,
        redirect_uri="https://your.app/callback",
    )

exchange_code_for_token returns the JSON payload from Discord which includes access_token, refresh_token and expiry information.

When the access token expires, you can refresh it using the provided refresh token:

from disagreement.oauth import refresh_access_token

async def refresh(token: str):
    return await refresh_access_token(
        refresh_token=token,
        client_id="YOUR_CLIENT_ID",
        client_secret="YOUR_CLIENT_SECRET",
    )

1.2 KiB Raw Blame History

OAuth2 Setup

1.2 KiB

Raw Blame History