发送订阅消息

简要描述
  • 发送订阅消息
请求URL
  • http://localhost:8500/message/subscribe/send
请求方式
  • post
Header
header 示例值 必选 类型 说明
miniCode xiaoxin string 小程序标识
请求参数示例
{
  "touser": "oge3Z5fPtiGWgASWWi63niZ8I3Hk",
  "templateId": "YptC73H0r4NZoCTfG2dbBwRVincaxFqltgP_zLQ0zgA",
  "page": "pages/index/index",
  "miniprogramState": "developer",
  "lang": "zh_CN",
  "data": {
    "name3": {
      "value": "张三"
    },
    "date2": {
      "value": "2018-01-01"
    }
  }
}
请求json字段说明
字段名 必选 类型 说明
touser string 接收者(用户)的 openid
templateId string 所需下发的订阅模板id
page string 点击模板卡片后的跳转页面,仅限本小程序内的页面。支持带参数,(示例index?foo=bar)。该字段不填则模板无跳转。
miniprogramState string 跳转小程序类型:developer为开发版;trial为体验版;formal为正式版;默认为正式版
lang string 进入小程序查看”的语言类型,支持zh_CN(简体中文)、en_US(英文)、zh_HK(繁体中文)、zh_TW(繁体中文),默认为zh_CN
data object 模板内容,格式形如 { “key1”: { “value”: any }, “key2”: { “value”: any } }
成功返回示例
{
  "data": {},
  "head": {
    "code": 0,
    "msg": "ok"
  }
}
成功返回示例的参数说明
参数名 类型 说明
data object 数据
head object 消息头
code string 返回码
msg string 消息文本
备注

返回码 code 说明:
参考地址: https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/subscribe-message/subscribeMessage.send.html
40003: touser字段openid为空或者不正确
40037: 订阅模板id为空不正确
43101: 用户拒绝接受消息,如果用户之前曾经订阅过,则表示用户取消了订阅关系
47003: 模板参数不准确,可能为空或者不满足规则,errmsg会提示具体是哪个字段出错
41030: page路径不正确,需要保证在现网版本小程序中存在,与app.json保持一致