wechat-oa-sdk 1.0.5

WeChat Official Account API SDK 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

use serde::{Deserialize, Serialize};
use std::collections::HashMap;

/// Template message data item.
#[derive(Debug, Clone, Serialize)]
pub struct TemplateDataItem {
    pub value: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub color: Option<String>,
}

impl TemplateDataItem {
    pub fn new(value: impl Into<String>) -> Self {
        Self {
            value: value.into(),
            color: None,
        }
    }

    pub fn with_color(mut self, color: impl Into<String>) -> Self {
        self.color = Some(color.into());
        self
    }
}

/// Mini program link for template message.
#[derive(Debug, Clone, Serialize)]
pub struct TemplateMiniProgram {
    pub appid: String,
    pub pagepath: Option<String>,
}

/// Template message request.
#[derive(Debug, Clone, Serialize)]
pub struct TemplateMessage {
    /// Receiver's OpenID
    pub touser: String,
    /// Template ID
    pub template_id: String,
    /// Click URL (optional)
    #[serde(skip_serializing_if = "Option::is_none")]
    pub url: Option<String>,
    /// Mini program link (optional, takes priority over url)
    #[serde(skip_serializing_if = "Option::is_none")]
    pub miniprogram: Option<TemplateMiniProgram>,
    /// Template data
    pub data: HashMap<String, TemplateDataItem>,
    /// Client message ID (for deduplication)
    #[serde(skip_serializing_if = "Option::is_none")]
    pub client_msg_id: Option<String>,
}

impl TemplateMessage {
    pub fn new(
        to_user: impl Into<String>,
        template_id: impl Into<String>,
        data: HashMap<String, TemplateDataItem>,
    ) -> Self {
        Self {
            touser: to_user.into(),
            template_id: template_id.into(),
            url: None,
            miniprogram: None,
            data,
            client_msg_id: None,
        }
    }

    pub fn with_url(mut self, url: impl Into<String>) -> Self {
        self.url = Some(url.into());
        self
    }

    pub fn with_miniprogram(mut self, appid: impl Into<String>, pagepath: Option<String>) -> Self {
        self.miniprogram = Some(TemplateMiniProgram {
            appid: appid.into(),
            pagepath,
        });
        self
    }

    pub fn with_client_msg_id(mut self, id: impl Into<String>) -> Self {
        self.client_msg_id = Some(id.into());
        self
    }
}

/// Response from sending template message.
#[derive(Debug, Clone, Deserialize)]
pub struct SendTemplateResponse {
    pub errcode: i64,
    pub errmsg: String,
    pub msgid: Option<i64>,
}

/// Template item from template list.
#[derive(Debug, Clone, Deserialize)]
pub struct TemplateItem {
    pub template_id: String,
    pub title: String,
    pub primary_industry: String,
    pub deputy_industry: String,
    pub content: String,
    pub example: String,
}

/// Response from getting template list.
#[derive(Debug, Clone, Deserialize)]
pub struct TemplateListResponse {
    pub template_list: Vec<TemplateItem>,
}

/// Industry information.
#[derive(Debug, Clone, Deserialize)]
pub struct Industry {
    pub first_class: String,
    pub second_class: String,
}

/// Response from getting industry.
#[derive(Debug, Clone, Deserialize)]
pub struct GetIndustryResponse {
    pub primary_industry: Industry,
    pub secondary_industry: Industry,
}