labrador 0.2.3

Labrador - Mini thirdpart client for rust.
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

use serde::{Serialize, Deserialize};
use serde_json::{Value};

use crate::{session::SessionStore, request::{RequestType}, WechatCommonResponse, LabradorResult, WechatCpClient};
use crate::wechat::cp::method::{CpDepartmentMethod, WechatCpMethod};

/// 部门管理
#[derive(Debug, Clone)]
pub struct WechatCpDepartment<'a, T: SessionStore> {
    client: &'a WechatCpClient<T>,
}

#[allow(unused)]
impl<'a, T: SessionStore> WechatCpDepartment<'a, T> {

    #[inline]
    pub fn new(client: &WechatCpClient<T>) -> WechatCpDepartment<T> {
        WechatCpDepartment {
            client,
        }
    }

    /// <pre>
    /// 部门管理接口 - 创建部门.
    /// 最多支持创建500个部门
    /// 详情请见: https://work.weixin.qq.com/api/doc#90000/90135/90205
    /// </pre>
    pub async fn create(&self, req: WechatCpDepartInfo) -> LabradorResult<i64> {

        let v = self.client.post(WechatCpMethod::Department(CpDepartmentMethod::Create), vec![], req, RequestType::Json).await?.json::<Value>()?;
        let v = WechatCommonResponse::parse::<Value>(v)?;
        let tag_id = v["id"].as_i64().unwrap_or_default();
        Ok(tag_id)
    }

    /// <pre>
    /// 部门管理接口 - 获取子部门ID列表.
    /// 详情请见: https://developer.work.weixin.qq.com/document/path/95350
    /// </pre>
    pub async fn simple_list(&self, id: Option<i64>) -> LabradorResult<WechatCpDepartSimpleResponse> {
        let mut query = vec![];
        if let Some(id) = id {
            query.push(("id".to_string(), id.to_string()));
        }
        let v = self.client.get(WechatCpMethod::Department(CpDepartmentMethod::SimpleList), query, RequestType::Json).await?.json::<Value>()?;
        WechatCommonResponse::parse::<WechatCpDepartSimpleResponse>(v)
    }


    /// <pre>
    /// 部门管理接口 - 获取部门列表.
    /// 详情请见: https://work.weixin.qq.com/api/doc#90000/90135/90208
    /// </pre>
    pub async fn list(&self, id: Option<i64>) -> LabradorResult<WechatCpDepartResponse> {
        let mut query = vec![];
        if let Some(id) = id {
            query.push(("id".to_string(), id.to_string()));
        }
        let v = self.client.get(WechatCpMethod::Department(CpDepartmentMethod::List), query, RequestType::Json).await?.json::<Value>()?;
        WechatCommonResponse::parse::<WechatCpDepartResponse>(v)
    }

    /// <pre>
    /// 部门管理接口 - 更新部门.
    /// 详情请见: https://work.weixin.qq.com/api/doc#90000/90135/90206
    /// 如果id为0(未部门),1(黑名单),2(星标组)，或者不存在的id，微信会返回系统繁忙的错误
    /// </pre>
    pub async fn update(&self, req: WechatCpDepartInfo) -> LabradorResult<WechatCommonResponse> {
        self.client.post(WechatCpMethod::Department(CpDepartmentMethod::Update), vec![], req, RequestType::Json).await?.json::<WechatCommonResponse>()
    }

    /// <pre>
    /// 部门管理接口 - 删除部门.
    /// 详情请见: https://work.weixin.qq.com/api/doc#90000/90135/90207
    /// 应用须拥有指定部门的管理权限
    /// </pre>
    pub async fn delete(&self, depart_id: i64) -> LabradorResult<WechatCommonResponse> {
        self.client.get(WechatCpMethod::Department(CpDepartmentMethod::Delete(depart_id)), vec![], RequestType::Json).await?.json::<WechatCommonResponse>()
    }
}

//----------------------------------------------------------------------------------------------------------------------------
/// 企业微信的部门
#[derive(Debug, Clone,Serialize, Deserialize)]
pub struct WechatCpDepartInfo {
    pub id: Option<i32>,
    pub name: Option<String>,
    pub en_name: Option<String>,
    pub parentid: Option<i32>,
    pub order: Option<i32>,
}

#[derive(Debug, Clone,Serialize, Deserialize)]
pub struct WechatCpDepartResponse {
    pub department: Vec<WechatCpDepartInfo>,
}

#[derive(Debug, Clone,Serialize, Deserialize)]
pub struct WechatCpDepartSimpleResponse {
    pub department_id: Vec<WechatCpDepartInfo>,
}