【小程序】微信小程序开发，给用户发送一次性订阅消息，常见参数长度和数据类型说明，你值得收藏

🌹欢迎来到《小5讲堂》🌹
🌹这是《小程序》系列文章，每篇文章将以博主理解的角度展开讲解。🌹
🌹温馨提示：博主能力有限，理解水平有限，若有不对之处望指正！🌹

在这里插入图片描述

前言

这次的发送小程序订阅消息的API接口，知道一些参数会有长度限制，但是具体是多长，有时候时间久了，容易忘记，或者平台可能已经修改了规则。
所以本次就简单记录下官方对于发送订阅消息的一些参数信息。

服务通知

发送一次性订阅服务，接收效果如下：
在这里插入图片描述

接口调用

API接口

在调用发送订阅消息接口前，需要调用接口获取AccessToken接口。

post请求
https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=ACCESS_TOKEN

请求参数

关键是data参数

属性	类型	必填	说明
`access_token`	string	是	接口调用凭证，该参数为 URL 参数，非 Body 参数。使用 `getAccessToken` 或 `authorizer_access_token`。
`template_id`	string	是	所需下发的订阅模板 ID。
`page`	string	否	点击模板卡片后的跳转页面，仅限本小程序内的页面。支持带参数（如 `index?foo=bar`）。无跳转时可不填。
`touser`	string	是	接收者（用户）的 openid。
`data`	object	是	模板内容，格式如：`"phrase3": { "value": "审核通过" }`，`"name1": { "value": "订阅" }` 等。
`miniprogram_state`	string	是	跳转小程序类型：`developer`（开发版）、`trial`（体验版）、`formal`（正式版）。默认为 `formal`。
`lang`	string	是	进入小程序查看的语言类型，支持 `zh_CN`（简体中文）、`en_US`（英文）、`zh_HK`（繁体中文）、`zh_TW`（繁体中文）。默认为 `zh_CN`。

Data参数说明

订阅消息参数值内容限制说明

参数类别	参数说明	参数值限制	说明
`thing.DATA`	事物	20个以内字符	可汉字、数字、字母或符号组合。
`number.DATA`	数字	32位以内数字	只能数字，可带小数。
`letter.DATA`	字母	32位以内字母	只能字母。
`symbol.DATA`	符号	5位以内符号	只能符号。
`character_string.DATA`	字符串	32位以内数字、字母或符号	可数字、字母或符号组合。
`time.DATA`	时间	24小时制格式（支持+年月日），支持短时间段	例如：`15:01`，或：`2019年10月1日 15:01`，用“-”连接两个时间点。
`date.DATA`	日期	年月日格式（支持+24小时时间），支持短时间段	例如：`2019年10月1日`，或：`2019年10月1日 15:01`，用“-”连接两个时间点。
`amount.DATA`	金额	1个币种符号+10位以内纯数字，可带小数	结尾可带“元”，例如：`¥100.50元`。
`phone_number.DATA`	电话	17位以内，数字、符号	例如：`+86-0766-66888866`。
`car_number.DATA`	车牌	8位以内，首位和末位可为汉字，其余为字母或数字	例如：`粤A82888挂`。
`name.DATA`	姓名	10个以内纯汉字或20个以内纯字母或符号	中文名限10字内；英文名限20字母内；混合按中文名计算（10字内）。
`phrase.DATA`	汉字	5个以内汉字	例如：`配送中`。
`enum.DATA`	枚举值	只能上传枚举值范围内的字段值	需调用接口获取具体枚举值参考。

C#调用例子

博主这里选择的是下面模板，两个参数都是属于thing，所以都只能输入20个以内字符，程序上需要做一个长度逻辑判断，否则提交超过20个字符会发送失败。
在这里插入图片描述

public static string message_subscribe_send = "https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token={0}";      // 订阅信息发送public static async Task<string> MsgSubSend(string access_token)
{var requestBody= new{thing1 = new{value = $"xxx"},thing2 = new{value = $"xxx"},};string url = string.Format(message_subscribe_send, access_token);var client = new RestClient(url);var request = new RestRequest();request.Method = Method.Post;request.AddHeader("Content-Type", "application/json");// 请求体内容 - 例如下面/*var requestBody = new{touser = 小程序用户openid,	// 接收消息的用户IDpage = "pages/index/index",	// 点击查看详情时跳转到的小程序页template_id,				// 模板IDdata						// 具体请求数据};*/// 将请求体序列化为JSON字符串string jsonRequestBody = System.Text.Json.JsonSerializer.Serialize(requestBody);request.AddParameter("application/json", jsonRequestBody, ParameterType.RequestBody);request.AddJsonBody(requestBody);var response = await client.ExecuteAsync(request);// {"errcode":43101,"errmsg":"user refuse to accept the msg rid: 687c5367-120bba99-2648e680"}// {"errcode":47003,"errmsg":"argument invalid! data.thing1.value invalid rid: 687c53ec-71c2491d-739b7172"}// {"errcode":0,"errmsg":"ok","msgid":4083364991775162371}return response?.Content ?? string.Empty;
}