Struct HttpClient 

pub struct HttpClient { /* private fields */ }

Discord REST API client.

Handles all HTTP communication with Discord, including:

• Authentication (Bot token)
• Rate limit tracking and waiting
• JSON serialization/deserialization
• Error handling

Thread Safety

HttpClient can be cloned and shared across tasks. The inner reqwest::Client uses connection pooling internally.

Implementations

impl HttpClient

pub async fn list_auto_moderation_rules( &self, guild_id: Snowflake, ) -> Result<Vec<AutoModRule>, HttpError>

List Auto Moderation rules.

pub async fn get_auto_moderation_rule( &self, guild_id: Snowflake, rule_id: Snowflake, ) -> Result<AutoModRule, HttpError>

Get an Auto Moderation rule.

pub async fn create_auto_moderation_rule( &self, guild_id: Snowflake, params: &CreateAutoModRuleParams, ) -> Result<AutoModRule, HttpError>

Create an Auto Moderation rule.

pub async fn modify_auto_moderation_rule( &self, guild_id: Snowflake, rule_id: Snowflake, params: &ModifyAutoModRuleParams, ) -> Result<AutoModRule, HttpError>

Modify an Auto Moderation rule.

pub async fn delete_auto_moderation_rule( &self, guild_id: Snowflake, rule_id: Snowflake, ) -> Result<(), HttpError>

Delete an Auto Moderation rule.

impl HttpClient

pub async fn get_channel( &self, channel_id: Snowflake, ) -> Result<Channel<'static>, HttpError>

Get a channel.

pub async fn delete_channel( &self, channel_id: Snowflake, reason: Option<&str>, ) -> Result<Channel<'static>, HttpError>

Delete/Close a channel.

pub async fn create_channel( &self, guild_id: Snowflake, params: &CreateChannel<'_>, ) -> Result<Channel<'static>, HttpError>

Create a new channel in a guild.

pub async fn get_message( &self, channel_id: Snowflake, message_id: Snowflake, ) -> Result<Message<'static>, HttpError>

Get a single message.

pub async fn create_message_struct( &self, channel_id: Snowflake, message: &CreateMessage<'_>, ) -> Result<Message<'static>, HttpError>

Send a message to a channel.

pub async fn send_message( &self, channel_id: Snowflake, content: impl Into<String>, ) -> Result<Message<'static>, HttpError>

Send a simple text message.

pub async fn edit_message( &self, channel_id: Snowflake, message_id: Snowflake, content: impl Into<String>, ) -> Result<Message<'static>, HttpError>

Edit a message.

pub async fn delete_message( &self, channel_id: Snowflake, message_id: Snowflake, reason: Option<&str>, ) -> Result<(), HttpError>

Delete a message.

pub async fn bulk_delete_messages( &self, channel_id: Snowflake, message_ids: &[Snowflake], ) -> Result<(), HttpError>

Bulk delete messages (2-100 messages, not older than 14 days). This is much faster than deleting one by one.

pub async fn create_webhook( &self, channel_id: Snowflake, name: &str, avatar: Option<&str>, ) -> Result<Webhook<'static>, HttpError>

Create a webhook.

pub async fn get_channel_webhooks( &self, channel_id: Snowflake, ) -> Result<Vec<Webhook<'static>>, HttpError>

Get channel webhooks.

pub async fn get_guild_webhooks( &self, guild_id: Snowflake, ) -> Result<Vec<Webhook<'static>>, HttpError>

Get guild webhooks.

pub async fn execute_webhook( &self, webhook_id: Snowflake, webhook_token: &str, params: &ExecuteWebhook, ) -> Result<Option<Message<'static>>, HttpError>

Execute webhook (send message).

impl HttpClient

pub fn new(token: impl Into<String>) -> Result<Self, HttpError>

Create a new HTTP client with the given bot token.

pub fn token(&self) -> &str

Get the bot token.

pub async fn get_gateway_bot(&self) -> Result<GatewayBotResponse, HttpError>

Get gateway bot information.

Returns the recommended number of shards, gateway URL, and session limits. This is essential for large bots to determine sharding configuration.

pub async fn get_current_user(&self) -> Result<CurrentUser, HttpError>

Get the current bot user.

pub async fn get_current_application( &self, ) -> Result<CurrentApplication, HttpError>

Get the current application.

pub async fn create_global_application_command( &self, application_id: Snowflake, command: &ApplicationCommand, ) -> Result<ApplicationCommand, HttpError>

Create a global application command.

pub async fn create_message( &self, channel_id: Snowflake, content: &CreateMessage<'_>, ) -> Result<Message<'static>, HttpError>

Create a message in a channel.

impl HttpClient

pub async fn list_guild_emojis( &self, guild_id: Snowflake, ) -> Result<Vec<Emoji<'static>>, HttpError>

List guild emojis.

pub async fn get_guild_emoji( &self, guild_id: Snowflake, emoji_id: Snowflake, ) -> Result<Emoji<'static>, HttpError>

Get guild emoji.

pub async fn create_guild_emoji( &self, guild_id: Snowflake, params: &CreateEmojiParams, ) -> Result<Emoji<'static>, HttpError>

Create guild emoji.

pub async fn modify_guild_emoji( &self, guild_id: Snowflake, emoji_id: Snowflake, params: &ModifyEmojiParams, ) -> Result<Emoji<'static>, HttpError>

Modify guild emoji.

pub async fn delete_guild_emoji( &self, guild_id: Snowflake, emoji_id: Snowflake, ) -> Result<(), HttpError>

Delete guild emoji.

pub async fn list_guild_stickers( &self, guild_id: Snowflake, ) -> Result<Vec<Sticker<'static>>, HttpError>

List guild stickers.

pub async fn get_guild_sticker( &self, guild_id: Snowflake, sticker_id: Snowflake, ) -> Result<Sticker<'static>, HttpError>

Get guild sticker.

pub async fn create_guild_sticker( &self, guild_id: Snowflake, params: &CreateStickerParams, ) -> Result<Sticker<'static>, HttpError>

Create guild sticker.

pub async fn delete_guild_sticker( &self, guild_id: Snowflake, sticker_id: Snowflake, ) -> Result<(), HttpError>

Delete guild sticker.

impl HttpClient

pub async fn get_member( &self, guild_id: Snowflake, user_id: Snowflake, ) -> Result<GuildMember<'static>, HttpError>

Get a guild member.

pub async fn list_members( &self, guild_id: Snowflake, limit: Option<u32>, after: Option<Snowflake>, ) -> Result<Vec<GuildMember<'static>>, HttpError>

List guild members.

pub async fn kick_member( &self, guild_id: Snowflake, user_id: Snowflake, reason: Option<&str>, ) -> Result<(), HttpError>

Kick a member from the guild.

pub async fn ban_member( &self, guild_id: Snowflake, user_id: Snowflake, delete_message_seconds: Option<u32>, reason: Option<&str>, ) -> Result<(), HttpError>

Ban a member from the guild.

pub async fn unban_member( &self, guild_id: Snowflake, user_id: Snowflake, reason: Option<&str>, ) -> Result<(), HttpError>

Unban a member.

pub async fn modify_member( &self, guild_id: Snowflake, user_id: Snowflake, params: &ModifyMember<'_>, ) -> Result<GuildMember<'static>, HttpError>

Modify a guild member.

pub async fn get_roles( &self, guild_id: Snowflake, ) -> Result<Vec<Role<'static>>, HttpError>

Get all roles.

pub async fn create_role( &self, guild_id: Snowflake, params: &CreateRole<'_>, ) -> Result<Role<'static>, HttpError>

Create a new role.

pub async fn delete_role( &self, guild_id: Snowflake, role_id: Snowflake, reason: Option<&str>, ) -> Result<(), HttpError>

Delete a role.

pub async fn get_guild_audit_log( &self, guild_id: Snowflake, params: &GetAuditLogParams, ) -> Result<AuditLog<'static>, HttpError>

Get guild audit log.

pub async fn list_guild_soundboard_sounds( &self, guild_id: Snowflake, ) -> Result<Vec<SoundboardSound<'static>>, HttpError>

List soundboard sounds for a guild.

pub async fn get_guild_soundboard_sound( &self, guild_id: Snowflake, sound_id: Snowflake, ) -> Result<SoundboardSound<'static>, HttpError>

Get a specific soundboard sound.

pub async fn create_guild_soundboard_sound( &self, guild_id: Snowflake, payload: &Value, ) -> Result<SoundboardSound<'static>, HttpError>

Create a soundboard sound.

pub async fn modify_guild_soundboard_sound( &self, guild_id: Snowflake, sound_id: Snowflake, payload: &Value, ) -> Result<SoundboardSound<'static>, HttpError>

Modify a soundboard sound.

pub async fn delete_guild_soundboard_sound( &self, guild_id: Snowflake, sound_id: Snowflake, ) -> Result<(), HttpError>

Delete a soundboard sound.

impl HttpClient

pub async fn create_interaction_response( &self, interaction_id: Snowflake, token: &str, response: &InteractionResponse<'_>, ) -> Result<(), HttpError>

Create a response to an Interaction.

This is the initial response to an interaction (Slash Command, Button, etc.). You must respond within 3 seconds, or use InteractionCallbackType::DeferredChannelMessageWithSource.

pub async fn get_original_interaction_response( &self, application_id: Snowflake, token: &str, ) -> Result<Message<'static>, HttpError>

Get the original response message.

pub async fn edit_original_interaction_response<B: Serialize>( &self, application_id: Snowflake, token: &str, body: B, ) -> Result<Message<'static>, HttpError>

Edit the original response message.

This is used to update the message after a DEFER response.

pub async fn delete_original_interaction_response( &self, application_id: Snowflake, token: &str, ) -> Result<(), HttpError>

Delete the original response message.

pub async fn create_followup_message<B: Serialize>( &self, application_id: Snowflake, token: &str, body: B, ) -> Result<Message<'static>, HttpError>

Create a followup message.

Used to send additional messages after the initial response.

impl HttpClient

pub async fn list_skus( &self, application_id: Snowflake, ) -> Result<Vec<Sku>, HttpError>

List SKUs for an application.

pub async fn list_entitlements( &self, application_id: Snowflake, query: Option<&Value>, ) -> Result<Vec<Entitlement>, HttpError>

List entitlements for an application.

pub async fn get_entitlement( &self, application_id: Snowflake, entitlement_id: Snowflake, ) -> Result<Entitlement, HttpError>

Get an entitlement.

pub async fn create_test_entitlement( &self, application_id: Snowflake, payload: &Value, ) -> Result<Entitlement, HttpError>

Create a test entitlement.

pub async fn delete_test_entitlement( &self, application_id: Snowflake, entitlement_id: Snowflake, ) -> Result<(), HttpError>

Delete a test entitlement.