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
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

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

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

/// 菜单管理相关接口
#[derive(Debug, Clone)]
pub struct WechatCpMenu<'a, T: SessionStore> {
    client: &'a WechatCpClient<T>,
}

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

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

    /// <pre>
    /// 自定义菜单创建接口
    /// 详情请见: <a href="http://mp.weixin.qq.com/wiki/index.php?title=自定义菜单创建接口">文档</a>
    ///
    /// 注意: 这个方法使用配置里的agentId
    /// </pre>
    pub async fn create(&self, menu: WechatCpMenuInfo) -> LabradorResult<WechatCommonResponse> {
        self.create_with_agentid(self.client.agent_id.to_owned().unwrap_or_default(), menu).await
    }

    /// <pre>
    /// 自定义菜单创建接口
    /// 详情请见: <a href="http://mp.weixin.qq.com/wiki/index.php?title=自定义菜单创建接口">文档</a>
    /// </pre>
    pub async fn create_with_agentid(&self, agent_id: i32, req: WechatCpMenuInfo) -> LabradorResult<WechatCommonResponse> {
       self.client.post(WechatCpMethod::Menu(CpMenuMethod::Create(agent_id)), vec![], req, RequestType::Json).await?.json::<WechatCommonResponse>()
    }

    /// <pre>
    /// 自定义菜单删除接口
    /// 详情请见: <a href="http://mp.weixin.qq.com/wiki/index.php?title=自定义菜单删除接口">文档</a>
    ///
    /// 注意: 这个方法使用配置里的agentId
    /// </pre>
    pub async fn delete(&self) -> LabradorResult<WechatCommonResponse> {
        self.delete_with_agentid(self.client.agent_id.to_owned().unwrap_or_default()).await
    }

    /// <pre>
    /// 自定义菜单删除接口
    /// 详情请见: <a href="http://mp.weixin.qq.com/wiki/index.php?title=自定义菜单删除接口">文档</a>
    /// </pre>
    pub async fn delete_with_agentid(&self, agent_id: i32) -> LabradorResult<WechatCommonResponse> {
       self.client.post(WechatCpMethod::Menu(CpMenuMethod::Delete(agent_id)), vec![], Value::Null, RequestType::Json).await?.json::<WechatCommonResponse>()
    }

    /// <pre>
    /// 自定义菜单查询接口
    /// 详情请见: <a href="http://mp.weixin.qq.com/wiki/index.php?title=自定义菜单查询接口">文档</a>
    ///
    /// 注意: 这个方法使用配置里的agentId
    /// </pre>
    pub async fn get(&self) -> LabradorResult<WechatCommonResponse> {
        self.delete_with_agentid(self.client.agent_id.to_owned().unwrap_or_default()).await
    }

    /// <pre>
    /// 自定义菜单查询接口
    /// 详情请见: <a href="http://mp.weixin.qq.com/wiki/index.php?title=自定义菜单查询接口">文档</a>
    /// </pre>
    pub async fn get_with_agentid(&self, agent_id: i32) -> LabradorResult<WechatCpMenuInfo> {
       let v = self.client.post(WechatCpMethod::Menu(CpMenuMethod::Get(agent_id)), vec![], Value::Null, RequestType::Json).await?.json::<Value>()?;
        WechatCommonResponse::parse::<WechatCpMenuInfo>(v)
    }
}

//----------------------------------------------------------------------------------------------------------------------------

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct WechatCpMenuInfo {
    /// 企业编号
    pub buttons: Vec<WechatCpMenuButton>,
    pub match_rule: Option<WechatCpMenuRule>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct WechatCpMenuButton {
    /// <pre>
    /// 菜单的响应动作类型.
    /// view表示网页类型，
    /// click表示点击类型，
    /// miniprogram表示小程序类型
    /// </pre>
    #[serde(rename="type")]
    pub r#type: String,
    /// 菜单标题，不超过16个字节，子菜单不超过60个字节.
    pub name: String,
    /// <pre>
    /// 菜单KEY值，用于消息接口推送，不超过128字节.
    /// click等点击类型必须
    /// </pre>
    pub key: Option<String>,
    /// <pre>
    /// 网页链接.
    /// 用户点击菜单可打开链接，不超过1024字节。type为miniprogram时，不支持小程序的老版本客户端将打开本url。
    /// view、miniprogram类型必须
    /// </pre>
    pub url: Option<String>,
    /// <pre>
    /// 调用新增永久素材接口返回的合法media_id.
    /// media_id类型和view_limited类型必须
    /// </pre>
    pub media_id: Option<String>,
    /// <pre>
    /// 调用发布图文接口获得的article_id.
    /// article_id类型和article_view_limited类型必须
    /// </pre>
    pub article_id: Option<String>,
    /// <pre>
    /// 小程序的appid.
    /// miniprogram类型必须
    /// </pre>
    pub appid: Option<String>,
    /// <pre>
    /// 小程序的页面路径.
    /// miniprogram类型必须
    /// </pre>
    pub pagepath: Option<String>,
    pub sub_button: Vec<WechatCpMenuButton>,
}


#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct WechatCpMenuRule {
    pub tag_id: Option<String>,
    pub sex: Option<String>,
    pub province: Option<String>,
    pub city: Option<String>,
    pub client_platform_type: Option<String>,
    pub language: Option<String>,
}