disagreement/docs/http_client.md
Slipstream c099466024
Some checks failed
Deploy MkDocs / deploy (push) Has been cancelled
Add guild listing methods (#71)
2025-06-11 18:24:14 -06:00

32 lines
848 B
Markdown

# HTTP Client Options
Disagreement uses `aiohttp` for all HTTP requests. Additional options for the
underlying `aiohttp.ClientSession` can be provided when constructing a
`Client` or an `HTTPClient` directly.
```python
import aiohttp
from disagreement import Client
connector = aiohttp.TCPConnector(limit=50)
client = Client(
token="YOUR_TOKEN",
http_options={"proxy": "http://localhost:8080", "connector": connector},
)
```
These options are passed through to `aiohttp.ClientSession` when the session is
created. You can set a proxy URL, provide a custom connector, or supply any
other supported session argument.
## Get Current User Guilds
The HTTP client can list the guilds the bot user is in:
```python
from disagreement.http import HTTPClient
http = HTTPClient(token="TOKEN")
guilds = await http.get_current_user_guilds()
```