微信小程序 城市服務(wù)消息通路接口

2022-05-11 15:55 更新

results-page

接入微信城市服務(wù),業(yè)務(wù)方需確保功能的閉環(huán)服務(wù)體驗(yàn),需接入消息通路。點(diǎn)擊此處查看城市服務(wù)消息通路說(shuō)明。

調(diào)用方法

1、接口調(diào)用請(qǐng)求

請(qǐng)求方式:POST 請(qǐng)求地址:https://api.weixin.qq.com/cityservice/sendmsgdata?access_token=ACCESS_TOKEN

(1)獲取access_token方式請(qǐng)點(diǎn)擊此處查看;獲取openid方式請(qǐng)點(diǎn)擊此處查看。

(2)通過(guò)小程序提供服務(wù)時(shí),需使用小程序用戶 openid ,并使用與小程序關(guān)聯(lián)的、且申請(qǐng)了“消息通路”的公眾號(hào)的 access_token

2、以POST方式傳入json格式的參數(shù)

(1)模板申請(qǐng)成功后,將會(huì)分配biz_template_id,并根據(jù)模板推送渠道不同分別提供樣式ID:result_page_style_id、deal_msg_style_id、card_style_id。

(2)調(diào)用接口時(shí),通過(guò)POST方式傳入json格式的以下參數(shù),所有參數(shù)的數(shù)據(jù)類型均為“字符串”,且字符集默認(rèn)使用UTF-8。

字段說(shuō)明

參數(shù) 說(shuō)明 是否必填
openid 用戶唯一標(biāo)識(shí) 必填
biz_template_id 城市服務(wù)分配給公眾號(hào)的模板id 必填
result_page_style_id 結(jié)果頁(yè)樣式id 含結(jié)果頁(yè)必填
deal_msg_style_id 辦事記錄樣式id 含辦事記錄必填
card_style_id 頁(yè)卡樣式id 含頁(yè)卡必填
order_no 訂單號(hào),同一訂單號(hào)的辦事記錄會(huì)合并 必填
url 跳轉(zhuǎn)鏈接,用于服務(wù)通知、結(jié)果頁(yè)、待辦提醒 含結(jié)果頁(yè)必填
data 模板json數(shù)據(jù),其中color字段只對(duì)服務(wù)通知有效 必填

參數(shù)示例


{
           "openid":"OPENID",
           "biz_template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",
           "result_page_style_id":"cUjfPSEtwasWQFsJ5PXo218PexBaHy5jg_peVDe4WkY",
           "deal_msg_style_id":"cUjfPSEtwasWQFsJ5PXo24LeNjWbwMObXSHPNjVZ0uQ",
           "card_style_id":"cUjfPSEtwasWQFsJ5PXo2z8LSM0Q6FH05DCerWEVkDs",
           "order_no":"ORDER_NO",
           "url":"http://weixin.qq.com/download",
           "data":{
                   "first": {
                       "value":"恭喜你購(gòu)買成功!",
                       "color":"#173177"
                   },
                   "keynote1":{
                       "value":"巧克力",
                       "color":"#173177"
                   },
                   "keynote2": {
                       "value":"39.8元",
                       "color":"#173177"
                   },
                   "keynote3": {
                       "value":"2014年9月22日",
                       "color":"#173177"
                   },
                   "remark":{
                       "value":"歡迎再次購(gòu)買!",
                       "color":"#173177"
                   }
           }
}

注:data為數(shù)組時(shí)用[ ]括起“data”字段內(nèi)數(shù)據(jù)。

3、返碼說(shuō)明

在調(diào)用消息通路接口后,返回JSON數(shù)據(jù)包:

返回結(jié)果 返回碼 說(shuō)明
result_page_url 結(jié)果頁(yè)url 需跳轉(zhuǎn)至該url,替代原有的服務(wù)結(jié)果頁(yè)面。如未傳入result_page_style_id,則調(diào)用后result_page_url返回為空。
errcode 48001 api未授權(quán)
errcode 40097 1.參數(shù)錯(cuò)誤。2.或openid不來(lái)自有“消息通路”api權(quán)限的公眾號(hào)
errcode 82020 未關(guān)注公眾號(hào)的用戶,從未在城市服務(wù)訪問(wèn)過(guò)服務(wù)
errcode 82021 未關(guān)注公眾號(hào)的用戶,未在近30天內(nèi)通過(guò)城市服務(wù)訪問(wèn)服務(wù)
errcode 82022 未關(guān)注公眾號(hào)的用戶,通過(guò)城市服務(wù)訪問(wèn)服務(wù)后,30天內(nèi)被下發(fā)數(shù)超過(guò)10次(醫(yī)療行業(yè)超過(guò)20次)
errcode 82023 未關(guān)注公眾號(hào)的用戶,1個(gè)小時(shí)內(nèi)被下發(fā)次數(shù)超過(guò)5次
errcode 82024 order_no異常,例如所有用戶的業(yè)務(wù)訂單號(hào)都用同一個(gè)
errcode 82025 URL無(wú)效
errcode 82026 1.服務(wù)已下線。2.或服務(wù)在審核中且審核期超過(guò)了30天

正常時(shí)的返回JSON數(shù)據(jù)包示例:


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

注:如未傳入結(jié)果頁(yè)樣式ID(result_page_style_id),則result_page_url結(jié)果為空

4、頁(yè)面報(bào)錯(cuò)提示

提示信息 說(shuō)明
中文顯示錯(cuò)誤 字符集未用utf8
參數(shù)錯(cuò)誤 json參數(shù)錯(cuò)誤
非本人,頁(yè)面打開(kāi)失敗 非本人openid;或登錄態(tài)獲取失敗
請(qǐng)?jiān)谖⑿艃?nèi)打開(kāi) 需在微信內(nèi)打開(kāi)頁(yè)面
系統(tǒng)錯(cuò)誤 其他錯(cuò)誤


以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)