results-page

接入微信城市服务,业务方需确保功能的闭环服务体验,需接入消息通路。点击此处查看城市服务消息通路说明

调用方法

1、接口调用请求

请求方式:POST 请求地址:https://api.weixin.qq.com/cityservice/sendmsgdata?access\_token=ACCESS\_TOKEN

(1)获取access_token方式请点击此处查看;获取openid方式请点击此处查看

(2)通过小程序提供服务时,需使用小程序用户 openid ,并使用与小程序关联的、且申请了“消息通路”的公众号的 access_token

2、以POST方式传入json格式的参数

(1)模板申请成功后,将会分配biz_template_id,并根据模板推送渠道不同分别提供样式ID:result_page_style_iddeal_msg_style_idcard_style_id

(2)调用接口时,通过POST方式传入json格式的以下参数,所有参数的数据类型均为“字符串”,且字符集默认使用UTF-8。

字段说明

参数说明是否必填
openid用户唯一标识必填
biz_template_id城市服务分配给公众号的模板id必填
result_page_style_id结果页样式id含结果页必填
deal_msg_style_id办事记录样式id含办事记录必填
card_style_id页卡样式id含页卡必填
order_no订单号,同一订单号的办事记录会合并必填
url跳转链接,用于服务通知、结果页、待办提醒含结果页必填
data模板json数据,其中color字段只对服务通知有效必填

参数示例

  1. {
  2. "openid":"OPENID",
  3. "biz_template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",
  4. "result_page_style_id":"cUjfPSEtwasWQFsJ5PXo218PexBaHy5jg_peVDe4WkY",
  5. "deal_msg_style_id":"cUjfPSEtwasWQFsJ5PXo24LeNjWbwMObXSHPNjVZ0uQ",
  6. "card_style_id":"cUjfPSEtwasWQFsJ5PXo2z8LSM0Q6FH05DCerWEVkDs",
  7. "order_no":"ORDER_NO",
  8. "url":"http://weixin.qq.com/download",
  9. "data":{
  10. "first": {
  11. "value":"恭喜你购买成功!",
  12. "color":"#173177"
  13. },
  14. "keynote1":{
  15. "value":"巧克力",
  16. "color":"#173177"
  17. },
  18. "keynote2": {
  19. "value":"39.8元",
  20. "color":"#173177"
  21. },
  22. "keynote3": {
  23. "value":"2014年9月22日",
  24. "color":"#173177"
  25. },
  26. "remark":{
  27. "value":"欢迎再次购买!",
  28. "color":"#173177"
  29. }
  30. }
  31. }

注:data为数组时用[ ]括起“data”字段内数据。

3、返码说明

在调用消息通路接口后,返回JSON数据包:

返回结果返回码说明
result_page_url结果页url需跳转至该url,替代原有的服务结果页面。如未传入result_page_style_id,则调用后result_page_url返回为空。
errcode48001api未授权
errcode400971.参数错误。2.或openid不来自有“消息通路”api权限的公众号
errcode82020未关注公众号的用户,从未在城市服务访问过服务
errcode82021未关注公众号的用户,未在近30天内通过城市服务访问服务
errcode82022未关注公众号的用户,通过城市服务访问服务后,30天内被下发数超过10次(医疗行业超过20次)
errcode82023未关注公众号的用户,1个小时内被下发次数超过5次
errcode82024order_no异常,例如所有用户的业务订单号都用同一个
errcode82025URL无效
errcode820261.服务已下线。2.或服务在审核中且审核期超过了30天

正常时的返回JSON数据包示例:

  1. {
  2. "errcode":0,
  3. "errmsg":"ok",
  4. "result_page_url":"https://city.weixin.qq.com/static/resultpagenew.html?openid=ont-9vjAcIdSU-LgB7ubALAVJO9U&biz_template_id=ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY #wechat_redirect"
  5. }

注:如未传入结果页样式ID(result_page_style_id),则result_page_url结果为空

4、页面报错提示

提示信息说明
中文显示错误字符集未用utf8
参数错误json参数错误
非本人,页面打开失败非本人openid;或登录态获取失败
请在微信内打开需在微信内打开页面
系统错误其他错误