W3Cschool
恭喜您成為首批注冊(cè)用戶
獲得88經(jīng)驗(yàn)值獎(jiǎng)勵(lì)
接入微信城市服務(wù),業(yè)務(wù)方需確保功能的閉環(huán)服務(wù)體驗(yàn),需接入消息通路。點(diǎn)擊此處查看城市服務(wù)消息通路說(shuō)明。
請(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
(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é)果為空
提示信息 | 說(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ò)誤 |
Copyright©2021 w3cschool編程獅|閩ICP備15016281號(hào)-3|閩公網(wǎng)安備35020302033924號(hào)
違法和不良信息舉報(bào)電話:173-0602-2364|舉報(bào)郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號(hào)
聯(lián)系方式:
更多建議: