dingtalk-stream-sdk-rust 0.1.0

An **UNOFFICIAL** Rust SDK focused on the development of DingTalk robots.
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

//! Types and methods to create group
// 
use crate::Client;
use anyhow::{bail, Result};
use serde::{Deserialize, Serialize};

const CREATE_URL: &str = "https://oapi.dingtalk.com/chat/create";

impl Client {
    /// create group via [`CreateRequest`], return group (open_conversation_id, chatid)
    pub async fn create_group(&self, req: CreateRequest) -> Result<(String, String)> {
        let token = self.token().await?;
        let resp: CreateResposne = self
            .post(format!("{}?access_token={}", CREATE_URL, token), req)
            .await?;

        if resp.errcode != 0 {
            bail!("create group error: {} - {}", resp.errcode, resp.errmsg);
        }

        Ok((resp.open_conversation_id, resp.chatid))
    }
}

/// group create request
///
/// refer to [official doc](https://open.dingtalk.com/document/orgapp/create-group-session#h2-3kz-gpn-suq) see more detail for each field
#[derive(Serialize, Default)]
#[serde(rename_all = "camelCase")]
pub struct CreateRequest {
    pub name: String,
    pub owner: String,
    pub useridlist: Vec<String>,

    /// Can new members view 100 historical messages
    /// - 1: can
    /// - 0: can not (default)
    pub show_history_type: u8,

    /// Can the group be searched
    /// - 0: can not (default)
    /// - 1: can
    pub searchable: u8,

    /// Do user need verification to join the group
    /// - 0: need not (default)
    /// - 1: need
    pub validation_type: u8,

    /// @all usage scope
    /// - 0: all people can use @all (default)
    /// - 1: only group owner can use @all
    pub mention_all_authority: u8,

    /// Group management type
    /// - 0: everyone can manage (default)
    /// - 1: only group owner can manage
    pub management_type: u8,

    /// Whether to enable chat banned in group
    /// - 0: no (default)
    /// - 1: yes
    pub chat_banned_type: u8,
}

/// group create response
///
/// refer to [official doc](https://open.dingtalk.com/document/orgapp/create-group-session#h2-xyy-jpo-c7q) for more details
#[derive(Deserialize)]
#[serde(rename_all = "camelCase")]
struct CreateResposne {
    #[serde(default)]
    open_conversation_id: String,
    #[serde(default)]
    chatid: String,
    #[serde(default)]
    #[allow(dead_code)]
    conversation_tag: u32,
    errmsg: String,
    errcode: u32,
}