Skip to main content

wechat_mp_qrcode/
lib.rs

1//! 小程序码与小程序链接
2//!
3//! 文档:[小程序码与小程序链接](https://developers.weixin.qq.com/miniprogram/dev/server/API/)
4
5mod code;
6mod link;
7
8pub use code::{
9    create_qrcode, get_qrcode, get_unlimited_qrcode, CreateQrcodeRequest, GetQrcodeRequest,
10    GetUnlimitedQrcodeRequest,
11};
12pub use link::{
13    generate_scheme, generate_short_link, generate_url_link, GenerateSchemeRequest,
14    GenerateShortLinkRequest, GenerateUrlLinkRequest, SchemeResponse, ShortLinkResponse,
15    UrlLinkResponse,
16};
17
18use wechat_mp_core::MpClient;
19
20/// 小程序码 / 链接 API 门面
21#[derive(Clone)]
22pub struct QrcodeApi {
23    client: MpClient,
24}
25
26impl QrcodeApi {
27    /// 基于已有客户端创建
28    pub fn new(client: MpClient) -> Self {
29        Self { client }
30    }
31
32    /// 获取小程序码(有数量限制)
33    pub async fn get_qrcode(&self, req: &GetQrcodeRequest) -> wechat_mp_core::Result<Vec<u8>> {
34        get_qrcode(&self.client, req).await
35    }
36
37    /// 获取不限制的小程序码
38    pub async fn get_unlimited_qrcode(
39        &self,
40        req: &GetUnlimitedQrcodeRequest,
41    ) -> wechat_mp_core::Result<Vec<u8>> {
42        get_unlimited_qrcode(&self.client, req).await
43    }
44
45    /// 获取小程序二维码(旧接口)
46    pub async fn create_qrcode(&self, req: &CreateQrcodeRequest) -> wechat_mp_core::Result<Vec<u8>> {
47        create_qrcode(&self.client, req).await
48    }
49
50    /// 获取加密 URL Scheme
51    pub async fn generate_scheme(
52        &self,
53        req: &GenerateSchemeRequest,
54    ) -> wechat_mp_core::Result<SchemeResponse> {
55        generate_scheme(&self.client, req).await
56    }
57
58    /// 获取加密 URL Link
59    pub async fn generate_url_link(
60        &self,
61        req: &GenerateUrlLinkRequest,
62    ) -> wechat_mp_core::Result<UrlLinkResponse> {
63        generate_url_link(&self.client, req).await
64    }
65
66    /// 获取 Short Link
67    pub async fn generate_short_link(
68        &self,
69        req: &GenerateShortLinkRequest,
70    ) -> wechat_mp_core::Result<ShortLinkResponse> {
71        generate_short_link(&self.client, req).await
72    }
73}