Struct DingTalk

pub struct DingTalk {
    pub dingtalk_type: DingTalkType,
    pub default_webhook_url: String,
    pub access_token: String,
    pub sec_token: String,
    pub direct_url: String,
    pub proxy: Option<String>,
}

DingTalk is a simple SDK for DingTalk webhook robot

Document https://ding-doc.dingtalk.com/doc#/serverapi2/qf2nxq

Sample code:

let dt = DingTalk::new("<token>", "");
dt.send_text("Hello world!")?;

At all sample:

dt.send_message(&DingTalkMessage::new_text("Hello World!").at_all())?;

Fields

dingtalk_type: DingTalkType

default_webhook_url: String

access_token: String

sec_token: String

direct_url: String

proxy: Option<String>

Implementations

impl DingTalk

pub fn from_token(token: &str) -> XResult<Self>

Create DingTalk from token: wechatwork:access_token dingtalk:access_token?sec_token

pub fn from_file(f: &str) -> XResult<Self>

Create DingTalk from file

Format see DingTalk::from_json(json: &str)

pub fn from_json(json: &str) -> XResult<Self>

Create DingTalk from JSON string

Format:

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

pub fn from_url(direct_url: &str) -> Self

Create DingTalk from url, for outgoing robot

pub fn new(access_token: &str, sec_token: &str) -> Self

Create DingTalk access_token is access token, sec_token can be empty ""

pub fn new_wechat(key: &str) -> Self

Create DingTalk for WeChat Work

pub fn proxy(self, proxy: &str) -> Self

Set send ding talk proxy

pub fn set_default_webhook_url(&mut self, default_webhook_url: &str)

Set default webhook url

pub async fn send_message( &self, dingtalk_message: DingTalkMessage, ) -> XResult<()>

Send DingTalk message

1. Create DingTalk JSON message
2. POST JSON message to DingTalk server

pub async fn send_text(&self, text_message: &str) -> XResult<()>

Send text message

pub async fn send_markdown(&self, title: &str, text: &str) -> XResult<()>

Send markdown message

pub async fn send_link( &self, link_title: &str, link_text: &str, link_pic_url: &str, link_message_url: &str, ) -> XResult<()>

Send link message

pub async fn send(&self, json_message: &str) -> XResult<()>

Direct send JSON message

pub fn generate_signed_url(&self) -> XResult<String>

Generate signed dingtalk webhook URL

Trait Implementations

impl Default for DingTalk

fn default() -> DingTalk

Returns the “default value” for a type.