微信公众号一次性订阅消息

说明


公众号或网页使用一次性订阅消息流程

第一步:需要用户同意授权,获取一次给用户推送一条订阅模板消息的机会

参数 是否必须 说明 action 是 直接填get_confirm即可 scene 是 重定向后会带上scene参数,开发者可以填0-10000的整形值,用来标识订阅场景值 template_id 是 订阅消息模板ID,登录公众平台后台,在接口权限列表处可查看订阅模板ID reserved 否 用于保持请求和回调的状态,授权请后原样带回给第三方。该参数可用于防止csrf攻击(跨站请求伪造攻击),建议第三方带上该参数,可设置为简单的随机数加session进行校验,开发者可以填写a-zA-Z0-9的参数值,最多128字节,要求做urlencode wechat_redirect 是 无论直接打开还是做页面302重定向时,必须带此参数

用户同意或取消授权后会返回相关信息。如果用户点击同意或取消授权,页面将跳转至: redirect_url/?openid=OPENID&template_id=TEMPLATE_ID&action=ACTION&scene=SCENE

参数 说明 openid 用户唯一标识,只在用户确认授权时才会带上 template_id 订阅消息模板ID action 用户点击动作,”confirm”代表用户确认授权,”cancel”代表用户取消授权 scene 订阅场景值 reserved 请求带入原样返回
{
    “touser”:”OPENID”,
    “template_id”:”TEMPLATE_ID”,
    “url”:”URL”,
    “miniprogram”:{
        “appid”:“xiaochengxuappid12345”,
        “pagepath”:“index?foo=bar”    
    },
    “scene”:”SCENE”,
    “title”:”TITLE”,
    “data”:{
        “content”:{
            “value”:”VALUE”,
            “color”:”COLOR”
        }
    }
}
参数 是否必须 说明 touser 是 填接收消息的用户openid template_id 是 订阅消息模板ID url 否 点击消息跳转的链接,需要有ICP备案 miniprogram 否 跳小程序所需数据,不需跳小程序可不用传该数据 pagepath 是 所需跳转到小程序的具体页面路径,支持带参数,(示例index?foo=bar) scene 是 订阅场景值 title 是 消息标题,15字以内 data 是 消息正文,value为消息内容文本(200字以内),没有固定格式,可用 换行,color为整段消息内容的字体颜色(目前仅支持整段消息为一种颜色)
经验分享 程序员 微信小程序 职场和发展