腾讯出行服务·开放平台

# 微信开放平台代理

# 1.推送微信公众号模板消息

  • 接口说明 本接口用于推送微信公众号模板消息。
  • 请求地址 /wx/miniapp/templatemsg
  • 请求方式 POST
  • 请求参数
参数名称 类型 最大长度 必选 说明
wx_app_id string 50 是 微信公众号APP ID参考附录二
open_id string 30 是 微信用户open Id
template_id string 50 是 微信公众号推送模板ID
data string 512 是 微信公众号推送内容为JSON格式格式形如 { "key1": { "value": any }, "key2": { "value": any } }
url string 500 否 模板跳转链接（海外帐号没有跳转能力）
color string 20 否 模板内容字体颜色，不填默认为黑色
mini_program_app_id string 50 否 所需跳转到的小程序appid（该小程序appid必须与发模板消息的公众号是绑定关联关系，暂不支持小游戏）
mini_program_page_path string 500 否 所需跳转到小程序的具体页面路径，支持带参数,（示例index?foo=bar），要求该小程序已发布，暂不支持小游戏
  • 返回数据
参数名称 类型 最大长度 必选 说明
code int 11 是 服务响应状态码，参见附录一
message string 64 是 服务响应状态说明，参见附录一
data object 是
msg_id long 11 是 微信推送结果 消息ID
  • 请求数据示例
{
    "api_key": "6a3304e09ADSFF2d45056",
    "seq_id": "81ea086e91df4bd8b90c39bda5f89362",
    "timestamp": 1589857181,
    "nonce": "liam",
    "sign": "9291E6F854A7C282803F642AA6CB7325",
    "wx_app_id": "wx29d15d946a7f2351",
    "open_id": "oYAz6vmRtnxv9Rb-hocFPGB0Cj0o",
    "template_id": "zFx85jVhJAGvG6Pvzkd6BzG393ypNi7rItaZxwHUgeU",
    "data": "{\"first\":{\"value\":\"恭喜您的车辆暂无任何违章记录，为您的交通安全意识点赞。\",\"color\":\"#173177\"},\"keyword1\":{\"value\":\"津RGA168\",\"color\":\"#173177\"},\"keyword2\":{\"value\":\"0个违章\",\"color\":\"#4FC92C\"},\"remark\":{\"value\":\"点击体验更多车主服务。\",\"color\":\"#173177\"}}",
    "mini_program_app_id": "wx735359beafd78b9f",
    "mini_program_page_path": "/launch/launch?target=violationSubscription&home=index&tplMsg=1&from=violationSubscribeTmplMsg&wecarId=5e815d81fab3006b844806c2"
}
  • 返回数据示例
{
    "code": 0,
    "message": "成功",
    "data": {
        "msg_id": 1346644672634093569
    }
}

# 2.推送微信小程序订阅消息

  • 接口说明 本接口用于推送微信小程序订阅消息
  • 请求地址 /wx/webapp/subscribemsg
  • 请求方式 POST
  • 请求参数
参数名称 类型 最大长度 必选 说明
wx_app_id string 50 是 微信小程序 APP ID参考附录二
open_id string 30 是 微信用户open Id
template_id string 50 是 微信小程序推送模板ID
data string 512 是 微信公众号推送内容 为JSON格式格式形如 { "key1": { "value": any }, "key2": { "value": any } }
page string 500 否 点击模板卡片后的跳转页面，仅限本小程序内的页面。支持带参数,（示例index?foo=bar）。该字段不填则模板无跳转。
  • 返回数据
参数名称 类型 最大长度 必选 说明
code int 11 是 服务响应状态码，参见附录一
message string 64 是 服务响应状态说明，参见附录一
data object 否
  • 请求数据示例
{
    "api_key": "6a3304e09ADSFF2d45056",
    "seq_id": "81ea086e91df4bd8b90c39bda5f89362",
    "timestamp": 1589857181,
    "nonce": "liam",
    "sign": "9291E6F854A7C282803F642AA6CB7325",
    "wx_app_id": "wx29d15d946a7f2351",
    "open_id": "oYAz6vmRtnxv9Rb-hocFPGB0Cj0o",
    "template_id": "zFx85jVhJAGvG6Pvzkd6BzG393ypNi7rItaZxwHUgeU",
"data": "{\"first\":{\"value\":\"恭喜您的车辆暂无任何违章记录，为您的交通安全意识点赞。\",\"color\":\"#173177\"},\"keyword1\":{\"value\":\"津RGA168\",\"color\":\"#173177\"},\"keyword2\":{\"value\":\"0个违章\",\"color\":\"#4FC92C\"},\"remark\":{\"value\":\"点击体验更多车主服务。\",\"color\":\"#173177\"}}",
“page”:”index?foo=bar”
}
  • 返回数据示例
{
    "code":0,
    "message":"successful",
   "data": { }
}

# 3.附录一

code message 解决方案
0 成功
-1 服务错误 服务商重试调用
1001 参数错误 服务商检查参数，重试调用
1002 鉴权错误 服务商检查参数，重试调用
1003 api_key不合法 服务商检查参数，重试调用
1200 微信处理失败 重试或者根据返回异常调整
1201 异常小程序/公众号编号 修复参数
1202 模板ID异常 修复参数
1203 用户ID异常 修复参数
1204 微信推送消息格式不正确 修复参数
1205 不支持的推送消息类型 修复参数

# 4.附录二

当前支持的微信账号（注：根据环境不同对appId进行了隔离，需要安装环境进行匹配调用）

  1. 我的车小程序

    APPID测试环境 wx735359beafd78b9f 线上 wxbd56b62a13d242d2

  2. 我的车公众号

    APPID测试环境 wx29d15d946a7f2351 线上 wx8328f7e3b01ba169

  3. 腾讯出行服务小程序

    APPID测试环境 wxa7ce727b525f80b0 线上 wx65cc950f42e8fff1

  4. 腾讯出行服务公众号

    APPID测试环境 wxa2fbbb7e7399bb35 线上 wx114696d4586cfa7f

← 省钱卡 →