dingtalk

Crates.iodingtalk
lib.rsdingtalk
version2.0.2
sourcesrc
created_at2019-12-17 15:51:33.30933
updated_at2021-01-08 16:55:40.915241
descriptionDingTalk Robot Util, Send text/markdown/link messages using DingTalk robot, 钉钉机器人
homepage
repositoryhttps://git.hatter.ink/hatter/dingtalk
max_upload_size
id190033
size32,887
Hatter Jiang (jht5945)

documentation

README

dingtalk

DingTalk Robot Util, Send text/markdown/link messages using DingTalk robot

钉钉机器人 Rust SDK

NOTE: From version 1.1.0 dingtalk uses reqwest 0.10.0's async/.await API.

Official reference: https://ding-doc.dingtalk.com/doc#/serverapi2/qf2nxq/0fa88adc

Sample 1:

use dingtalk::DingTalk;

#[tokio::main]
pub async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let dt = DingTalk::new("<token>", "");
    dt.send_text("Hello world!").await?;

    Ok(())
}

Need use crate: tokio = { version = "0.2.6", features = ["full"] }.

Sample 2 (Read token from file):

#[tokio::main]
pub async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let dt = DingTalk::from_file("~/.dingtalk-token.json")?;
    dt.send_text("Hello world!").await?;

    Ok(())
}

Sample, send markdown message:

dt.send_markdown("markdown title 001", r#"# markdown content 001
* line 0
* line 1
* line 2"#).await?;

Sample, send link message:

dt.send_link("link title 001", "link content 001", "https://hatter.ink/favicon.png", "https://hatter.ink/").await?;

Sample, send feed card message:

dt.send_message(DingTalkMessage::new_feed_card()
    .add_feed_card_link(DingTalkMessageFeedCardLink{
        title: "test feed card title 001".into(),
        message_url: "https://hatter.ink/".into(),
        pic_url: "https://hatter.ink/favicon.png".into(),
    })
    .add_feed_card_link(DingTalkMessageFeedCardLink{
        title: "test feed card title 002".into(),
        message_url: "https://hatter.ink/".into(),
        pic_url: "https://hatter.ink/favicon.png".into(),
    })
).await?;

Sample, send action card message(single btn):

dt.send_message(DingTalkMessage::new_action_card("action card 001", "action card text 001")
    .set_action_card_signle_btn(DingTalkMessageActionCardBtn{
        title: "test signle btn title".into(),
        action_url: "https://hatter.ink/".into(),
    })
).await?;

Sample, send action card message(multi btns):

dt.send_message(DingTalkMessage::new_action_card("action card 002", "action card text 002")
    .add_action_card_btn(DingTalkMessageActionCardBtn{
        title: "test signle btn title 01".into(),
        action_url: "https://hatter.ink/".into(),
    })
    .add_action_card_btn(DingTalkMessageActionCardBtn{
        title: "test signle btn title 02".into(),
        action_url: "https://hatter.ink/".into(),
    })
).await?;

JSON Config

DingTalk config:

{
  "access_token": "<access token>",
  "sec_token": "<sec token>"
}

WeChat Work config:

{
  "type": "wechat",
  "access_token": "<token>"
}

Changelog

  • v2.0.0
    • Remove 'a life cycle
  • v1.3.2
    • Add DingTalk::from_token
  • v1.3.1
    • Add DingTalk::new_wechat
  • v1.3.0
    • Suports WeChat Work now, add type "type": "wechat", supports method DingTalk::send_text
  • v1.2.1
    • Remove maplit crate
  • v1.2.0
    • Use serde and serde_json crates, replace json crate
  • v1.1.2
    • Use hmac and sha2 crates, replace rust-crypto crate
  • v1.1.1
    • DingTalk::from_json add direct_url
    • Fix problems by clippy
  • v1.1.0
    • Change fn to async/.await
  • v1.0.1
    • Change two fn names
    • Add readme sample codes
  • v1.0.0
  • v0.3.0
    • Add FeedCard message, send feed card message type
  • v0.2.1
    • Add Dingtalk::from_json, read token from JSON string
  • v0.2.0
    • Add DingTalk::from_file, read token from file
  • v0.1.2
    • Add Default::default() support
  • v0.1.1
    • Add set_default_webhook_url, default dingtalk webhook url
  • v0.1.0
    • Add DingTalk::send_link(...), send link message
  • v0.0.3
    • Add DingTalkMessage , can set at_all, at_mobiles now
Commit count: 0

cargo fmt