HTTP#

HTTP reference#

class nextcore.http.HTTPClient(*, trust_local_time=True, timeout=60, max_rate_limit_retries=10)#

The HTTP client to interface with the Discord API.

Example usage

http_client = HTTPClient()
await http_client.setup()

gateway = await http_client.get_gateway()

print(gateway["url"])

await http_client.close()

Parameters

trust_local_time (bool) – Whether to trust local time. If this is not set HTTP rate limiting will be a bit slower but may be a bit more accurate on systems where the local time is off.
timeout (float) – The default request timeout in seconds.
max_rate_limit_retries (int) – How many times to attempt to retry a request after rate limiting failed.

Return type

None

trust_local_time#

If this is enabled, the rate limiter will use the local time instead of the discord provided time. This may improve your bot’s speed slightly.

Warning

If your time is not correct, and this is set to True, this may result in more rate limits being hit.

Ubuntu

You can check if your clock is synchronized by running the following command:

timedatectl

If it is synchronized, it will show “System clock synchronized: yes” and “NTP service: running”

If the system clock is not synchronized but the ntp service is running you will have to wait a few minutes for it to sync.

To enable the ntp service run the following command:

sudo timedatectl set-ntp on

This will automatically sync the system clock every once in a while.

Arch

You can check if your clock is synchronized by running the following command:

timedatectl

If it is synchronized, it will show “System clock synchronized: yes” and “NTP service: running”

If the system clock is not synchronized but the ntp service is running you will have to wait a few minutes for it to sync.

To enable the ntp service run the following command:

sudo timedatectl set-ntp on

This will automatically sync the system clock every once in a while.

Windows

This can be turned on by going to Settings -> Time & language -> Date & time and turning on Set time automatically.

timeout#: The default request timeout in seconds.

default_headers#: The default headers to pass to every request.

max_retries#: How many times to attempt to retry a request after rate limiting failed.

Note

This does not retry server errors.

rate_limit_storages#

Classes to store rate limit information.

The key here is the rate_limit_key (often a user ID).

dispatcher#: Events from the HTTPClient. See the events

async add_guild_member(bot_authentication, user_authentication, guild_id, user_id, *, nick=UndefinedType.UNDEFINED, roles=UndefinedType.UNDEFINED, mute=UndefinedType.UNDEFINED, deaf=UndefinedType.UNDEFINED, bucket_priority=0, global_priority=0, wait=True)#

Adds a member to a guild

HTTP#

HTTP reference#

HTTP Wrappers#

HTTP errors#