Yet Another Discord Webhook
The objective of this crate is to grant asynchronous access to the Discord Webhook API. Beyond managing webhooks, this crate also allows for users to edit, obtain, and delete existing messages created by the webhook. There are several other crates that exist with similar functionality, however, I felt they were with missing features or not updated.
Contributions are encouraged! The API reference can be seen at Discord Webhook API. If you wish to add this to your project, either use cargo add yadwh or add the following line to your dependencies section in Cargo.toml:
toml
[dependencies]
yadwh = { git = "https://github.com/ohkthx/yadwh-rs" }
Features
- Asynchronous.
- Easy-to-use Webhook Client.
- Get, Edit, and Delete Webhooks.
- Create, Get, Edit, and Delete Webhook messages.
Documentation
Most of the documentation can be accessed by clicking the following link: docs.rs. That documentation is automatically generated and also accessible from crates.io.
Covered API requests
Client: use yadwh::webhook::WebhookAPI or use yadwh::WebhookAPI, create with WebhookAPI::new()
Webhook API:
- Get Webhook: WebhookAPI.get
- Modify Webhook: WebhookAPI.modify
- Delete Webhook: WebhookAPI.delete
- MessageAPI: WebhookAPI.message
- Create Message: WebhookAPI.message.create
- Get Message: WebhookAPI.message.get
- Edit Message: WebhookAPI.message.edit
- Delete Message: WebhookAPI.message.delete
TODO
- Support files / attachments.
Examples
Check above in the Covered API requests section for possibly covered examples. NOTE FOR BELOW: AAAABBBB is the Webhook ID, 11112222 is the Webhook Token, and CCCCDDDD is the Message ID for some requests.
WebhookAPI
- Get Webhook: get_webhook.rs
cargo run --example get_webhook --features examples -- AAAABBBB 11112222 CCCCDDDD
- Modify Webhook: modify_webhook.rs
cargo run --example modify_webhook --features examples -- AAAABBBB 11112222 CCCCDDDD
- Delete Webhook: delete_webhook.rs
cargo run --example delete_webhook --features examples -- AAAABBBB 11112222 CCCCDDDD
MessageAPI
- Create Message: create_message.rs
cargo run --example create_message --features examples -- AAAABBBB 11112222
- Create Thread Message (Forum Channel): createthreadmessage.rs
cargo run --example create_thread_message --features examples -- AAAABBBB 11112222 CCCCDDDD
- Get Message: get_message.rs
cargo run --example get_message --features examples -- AAAABBBB 11112222 CCCCDDDD
- Edit Message: edit_message.rs
cargo run --example edit_message --features examples -- AAAABBBB 11112222 CCCCDDDD
- Delete Message: delete_message.rs
cargo run --example delete_message --features examples -- AAAABBBB 11112222 CCCCDDDD
Tips Appreciated!
Wallet addresses are provided below.
Ethereum (ETH): 0x7d75f6a9c021fcc70691fec73368198823fb0f60
Bitcoin (BTC): bc1q75w3cgutug8qdxw3jlmqnkjlv9alt3jr7ftha0
Binance (BNB): 0x7d75f6a9c021fcc70691fec73368198823fb0f60