下发小程序和公众号统一的服务消息

调用本接口可以下发小程序和公众号统一的服务消息,详情见统一服务消息。使用过程中如遇到问题,可在开放平台服务商专区发帖交流。

请求地址

POST https://api.weixin.qq.com/cgi-bin/message/wxopen/template/uniform_send?access_token=ACCESS_TOKEN

请求参数

属性 类型 默认值 必填 说明
access_token String 第三方平台接口调用令牌authorizer_access_token
touser string 用户openid,可以是小程序的openid,也可以是mp_template_msg.appid对应的公众号的openid
mp_template_msg Object 公众号模板消息相关的信息,可以参考公众号模板消息接口;有此节点并且没有weapp_template_msg节点时,发送公众号模板消息

mp_template_msg 的结构

属性 类型 默认值 必填 说明
appid string 公众号appid,要求与小程序有绑定且同主体
template_id string 公众号模板id
url string 公众号模板消息所要跳转的url
miniprogram string 公众号模板消息所要跳转的小程序,小程序的必须与公众号具有绑定关系
data string 公众号模板消息的数据

请求数据示例

{
    "touser":"OPENID",
    "mp_template_msg":{
        "appid":"APPID ",
        "template_id":"TEMPLATE_ID",
        "url":"http://weixin.qq.com/download",
        "miniprogram":{
            "appid":"xiaochengxuappid12345",
            "pagepath":"index?foo=bar"
        },
        "data":{
            "first":{
                "value":"恭喜你购买成功!",
                "color":"#173177"
            },
            "keyword1":{
                "value":"巧克力",
                "color":"#173177"
            },
            "keyword2":{
                "value":"39.8元",
                "color":"#173177"
            },
            "keyword3":{
                "value":"2014年9月22日",
                "color":"#173177"
            },
            "remark":{
                "value":"欢迎再次购买!",
                "color":"#173177"
            }
        }
    }
}

返回值说明

返回的 JSON 数据包

属性 类型 说明
errcode number 错误码
errmsg string 错误信息

返回数据示例

{
 "errcode": 0,
 "errmsg": "ok"
}

错误码说明

错误码 错误信息 说明
0 成功
40037 模板id不正确,weapp_template_msg.template_id或者mp_template_msg.template_id
45009 接口调用超过限额
40003 touser不是正确的openid
40013 appid不正确,或者不符合绑定关系要求
其他错误码 请查看全局错误码