建站
咨詢
售后
建站咨詢
新聞中心
results-page
接入微信城市服務(wù)，業(yè)務(wù)方需確保功能的閉環(huán)服務(wù)體驗(yàn)，需接入消息通路。點(diǎn)擊此處查看城市服務(wù)消息通路說明。
創(chuàng)新互聯(lián)主要從事成都做網(wǎng)站、成都網(wǎng)站制作、網(wǎng)頁設(shè)計(jì)、企業(yè)做網(wǎng)站、公司建網(wǎng)站等業(yè)務(wù)。立足成都服務(wù)工布江達(dá),10多年網(wǎng)站建設(shè)經(jīng)驗(yàn),價(jià)格優(yōu)惠、服務(wù)專業(yè),歡迎來電咨詢建站服務(wù):028-86922220
調(diào)用方法
1、接口調(diào)用請求
請求方式：POST 請求地址：https://api.weixin.qq.com/cityservice/sendmsgdata?access_token=ACCESS_TOKEN
（1）獲取access_token方式請點(diǎn)擊此處查看；獲取openid方式請點(diǎn)擊此處查看。
（2）通過小程序提供服務(wù)時(shí)，需使用小程序用戶 openid ，并使用與小程序關(guān)聯(lián)的、且申請了“消息通路”的公眾號的 access_token
2、以POST方式傳入json格式的參數(shù)
（1）模板申請成功后，將會分配biz_template_id，并根據(jù)模板推送渠道不同分別提供樣式ID：result_page_style_id、deal_msg_style_id、card_style_id。
（2）調(diào)用接口時(shí)，通過POST方式傳入json格式的以下參數(shù)，所有參數(shù)的數(shù)據(jù)類型均為“字符串”，且字符集默認(rèn)使用UTF-8。
字段說明
| 參數(shù) | 說明 | 是否必填 |
|---|---|---|
| openid | 用戶唯一標(biāo)識 | 必填 |
biz_template_id | 城市服務(wù)分配給公眾號的模板id | 必填 |
result_page_style_id | 結(jié)果頁樣式id | 含結(jié)果頁必填 |
deal_msg_style_id | 辦事記錄樣式id | 含辦事記錄必填 |
card_style_id | 頁卡樣式id | 含頁卡必填 |
order_no | 訂單號，同一訂單號的辦事記錄會合并 | 必填 |
| url | 跳轉(zhuǎn)鏈接，用于服務(wù)通知、結(jié)果頁、待辦提醒 | 含結(jié)果頁必填 |
| data | 模板json數(shù)據(jù)，其中color字段只對服務(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":"恭喜你購買成功！",
"color":"#173177"
},
"keynote1":{
"value":"巧克力",
"color":"#173177"
},
"keynote2": {
"value":"39.8元",
"color":"#173177"
},
"keynote3": {
"value":"2014年9月22日",
"color":"#173177"
},
"remark":{
"value":"歡迎再次購買！",
"color":"#173177"
}
}
}
注：data為數(shù)組時(shí)用[ ]括起“data”字段內(nèi)數(shù)據(jù)。
3、返碼說明
在調(diào)用消息通路接口后，返回JSON數(shù)據(jù)包：
| 返回結(jié)果 | 返回碼 | 說明 |
|---|---|---|
result_page_url | 結(jié)果頁url | 需跳轉(zhuǎn)至該url，替代原有的服務(wù)結(jié)果頁面。如未傳入result_page_style_id，則調(diào)用后result_page_url返回為空。 |
| errcode | 48001 | api未授權(quán) |
| errcode | 40097 | 1.參數(shù)錯(cuò)誤。2.或openid不來自有“消息通路”api權(quán)限的公眾號 |
| errcode | 82020 | 未關(guān)注公眾號的用戶，從未在城市服務(wù)訪問過服務(wù) |
| errcode | 82021 | 未關(guān)注公眾號的用戶，未在近30天內(nèi)通過城市服務(wù)訪問服務(wù) |
| errcode | 82022 | 未關(guān)注公眾號的用戶，通過城市服務(wù)訪問服務(wù)后，30天內(nèi)被下發(fā)數(shù)超過10次（醫(yī)療行業(yè)超過20次） |
| errcode | 82023 | 未關(guān)注公眾號的用戶，1個(gè)小時(shí)內(nèi)被下發(fā)次數(shù)超過5次 |
| errcode | 82024 | order_no異常，例如所有用戶的業(yè)務(wù)訂單號都用同一個(gè) |
| errcode | 82025 | URL無效 |
| errcode | 82026 | 1.服務(wù)已下線。2.或服務(wù)在審核中且審核期超過了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é)果頁樣式ID（result_page_style_id），則result_page_url結(jié)果為空
4、頁面報(bào)錯(cuò)提示
| 提示信息 | 說明 |
|---|---|
| 中文顯示錯(cuò)誤 | 字符集未用utf8 |
| 參數(shù)錯(cuò)誤 | json參數(shù)錯(cuò)誤 |
| 非本人，頁面打開失敗 | 非本人openid；或登錄態(tài)獲取失敗 |
| 請?jiān)谖⑿艃?nèi)打開 | 需在微信內(nèi)打開頁面 |
| 系統(tǒng)錯(cuò)誤 | 其他錯(cuò)誤 |
網(wǎng)頁標(biāo)題：創(chuàng)新互聯(lián)小程序教程：微信小程序城市服務(wù)消息通路接口
文章URL：http://m.5511xx.com/article/cdicoji.html
