dingtalk 2.0.2

DingTalk Robot Util, Send text/markdown/link messages using DingTalk robot, 钉钉机器人
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153

# 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:
```rust
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):
```rust
#[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:
```rust
dt.send_markdown("markdown title 001", r#"# markdown content 001
* line 0
* line 1
* line 2"#).await?;
```

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

Sample, send feed card message:
```rust
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):
```rust
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):
```rust
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:
```json
{
  "access_token": "<access token>",
  "sec_token": "<sec token>"
}
```

WeChat Work config:
```json
{
  "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
    * `TEXT` -> `Text` ..., change enum caps
    * Add `ActionCard` message, send action card message type
    * Add `direct_url` for `DingTalk`, for outgoing robot
    * Implemented almost the functions listed on https://ding-doc.dingtalk.com/doc#/serverapi2/qf2nxq/0fa88adc
* 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