建站
咨詢
售后
建站咨詢
新聞中心
這里有您想知道的互聯(lián)網(wǎng)營(yíng)銷解決方案
創(chuàng)新互聯(lián)小程序教程：微信小程序 add
nearbyPoi.add
本接口應(yīng)在服務(wù)器端調(diào)用，詳細(xì)說明參見 服務(wù)端API。
創(chuàng)新互聯(lián)是一家專注于網(wǎng)站設(shè)計(jì)制作、成都網(wǎng)站建設(shè)與策劃設(shè)計(jì),大東網(wǎng)站建設(shè)哪家好?創(chuàng)新互聯(lián)做網(wǎng)站,專注于網(wǎng)站建設(shè)十年,網(wǎng)設(shè)計(jì)領(lǐng)域的專業(yè)建站公司;建站業(yè)務(wù)涵蓋:大東等地區(qū)。大東做網(wǎng)站價(jià)格咨詢:13518219792
本接口支持 云調(diào)用。需開發(fā)者工具版本 >= 1.02.1904090（最新 穩(wěn)定版下載）
wx-server-sdk >= 0.4.0
添加地點(diǎn)
調(diào)用方式：
- HTTPS 調(diào)用
- 云調(diào)用
HTTPS 調(diào)用
請(qǐng)求地址
POST https://api.weixin.qq.com/wxa/addnearbypoi?access_token=ACCESS_TOKEN
請(qǐng)求參數(shù)
| 屬性 | 類型 | 默認(rèn)值 | 必填 | 說明 |
|---|---|---|---|---|
| access_token | string | 是 | 接口調(diào)用憑證 | |
| is_comm_nearby | string | 是 | 必填,寫死為"1" | |
| pic_list | string | 是 | 門店圖片，最多9張，最少1張，上傳門店圖片如門店外景、環(huán)境設(shè)施、商品服務(wù)等，圖片將展示在微信客戶端的門店頁。圖片鏈接通過文檔https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1444738729中的《上傳圖文消息內(nèi)的圖片獲取URL》接口獲取。必填，文件格式為bmp、png、jpeg、jpg或gif，大小不超過5M pic_list是字符串，內(nèi)容是一個(gè)json | |
| service_infos | string | 是 | 必服務(wù)標(biāo)簽列表 必填，需要填寫 1、 服務(wù)標(biāo)簽ID 2、 服務(wù)類型tpye 3、 服務(wù)名稱name 詳細(xì)字段格式見下方《服務(wù)標(biāo)簽id編號(hào)、類型與服務(wù)名稱表》 4、 APPID 5、 對(duì)應(yīng)服務(wù)落地頁的path路徑：path路徑頁面要與對(duì)應(yīng)的服務(wù)標(biāo)簽一致，例如選取外賣服務(wù)，path路徑應(yīng)該是小程序的外賣對(duì)應(yīng)的那個(gè)頁面，path路徑獲取咨詢開發(fā)或者到小程序管理后臺(tái)-工具-生成小程序碼頁面獲取 6、新增服務(wù)描述desc：描述服務(wù)內(nèi)容，例如滿減、折扣等優(yōu)惠信息或新品、爆品等商品信息，僅標(biāo)準(zhǔn)服務(wù)都可添加，10個(gè)字符以內(nèi)。 service_infos是字符串，內(nèi)容是一個(gè)json | |
| kf_info | string | 是 | 客服信息 選填，可自定義服務(wù)頭像與昵稱，具體填寫字段見下方示例kf_info pic_list是字符串，內(nèi)容是一個(gè)json | |
| store_name | string | 是 | 門店名字 必填，門店名稱需按照所選地理位置自動(dòng)拉取騰訊地圖門店名稱，不可修改，如需修改請(qǐng)重現(xiàn)選擇地圖地點(diǎn)或重新創(chuàng)建地點(diǎn)。 | |
| hour | string | 是 | 營(yíng)業(yè)時(shí)間，格式11:11-12:12 必填 | |
| address | string | 是 | 地址 必填 | |
| poi_id | string | 是 | 如果創(chuàng)建新的門店，poi_id字段為空 如果更新門店，poi_id參數(shù)則填對(duì)應(yīng)門店的poi_id 選填 | |
| company_name | string | 是 | 主體名字 必填 | |
| contract_phone | string | 是 | 門店電話 必填 | |
| credential | string | 是 | 資質(zhì)號(hào) 必填, 15位營(yíng)業(yè)執(zhí)照注冊(cè)號(hào)或9位組織機(jī)構(gòu)代碼 | |
| qualification_list | string | 是 | 證明材料 必填 如果company_name和該小程序主體不一致，需要填qualification_list，詳細(xì)規(guī)則見附近的小程序使用指南-如何證明門店的經(jīng)營(yíng)主體跟公眾號(hào)或小程序帳號(hào)主體相關(guān)http://kf.qq.com/faq/170401MbUnim17040122m2qY.html | |
| map_poi_id | string | 是 | 對(duì)應(yīng)《在騰訊地圖中搜索門店》中的sosomap_poi_uid字段 騰訊地圖那邊有些數(shù)據(jù)不一致，如果不填map_poi_id的話，小概率會(huì)提交失敗！ 注： poi_id與map_poi_id關(guān)系： map_poi_id是騰訊地圖對(duì)于poi的唯一標(biāo)識(shí) poi_id是門店進(jìn)駐附近后的門店唯一標(biāo)識(shí) | |
| NearbyPoiError@error |
返回值
Object
返回的 JSON 數(shù)據(jù)包
| 屬性 | 類型 | 說明 |
|---|---|---|
| errmsg | string | 錯(cuò)誤信息 |
| errcode | number | 錯(cuò)誤碼 |
| data | object | 返回?cái)?shù)據(jù) |
data 的結(jié)構(gòu)
| 屬性 | 類型 | 說明 |
|---|---|---|
| audit_id | string | 審核單 ID |
| poi_id | string | 附近地點(diǎn) ID |
| related_credential | string | 經(jīng)營(yíng)資質(zhì)證件號(hào) |
注：添加門店需要審核，需要1到2個(gè)工作日
服務(wù)標(biāo)簽id編號(hào)、類型與服務(wù)名稱表
| ID | type | name(服務(wù)名稱) |
|---|---|---|
| 0 | 2 | 自定義服務(wù)，可自定義名稱(10個(gè)以內(nèi)) |
| 1 | 1 | 外送 |
| 2 | 1 | 快遞 |
| 3 | 1 | 充電 |
| 4 | 1 | 預(yù)約 |
| 5 | 1 | 掛號(hào) |
| 6 | 1 | 點(diǎn)餐 |
| 7 | 1 | 優(yōu)惠 |
| 8 | 1 | 乘車 |
| 9 | 1 | 會(huì)員 |
| 10 | 1 | 買單 |
| 11 | 1 | 排隊(duì) |
| 12 | 1 | 繳費(fèi) |
| 13 | 1 | 購票 |
| 14 | 1 | 到店自提 |
| 15 | 1 | 預(yù)定 |
頻率限制說明
添加請(qǐng)求暫不支持并發(fā)調(diào)用，建議使用時(shí)間隔1s進(jìn)行串行調(diào)用
請(qǐng)求示例
{
"is_comm_nearby": "1", //值固定
"kf_info": "{\"open_kf\":true,\"kf_headimg\":\"http://mmbiz.qpic.cn/mmbiz_jpg/kKMgNtnEfQzDKpLXYhgo3W3Gndl34gITqmP914zSwhajIEJzUPpx40P7R8fRe1QmicneQMhFzpZNhSLjrvU1pIA/0?wx_fmt=jpeg\",\"kf_name\":\"Harden\"}",
"pic_list": "{\"list\":[\"http://mmbiz.qpic.cn/mmbiz_jpg/kKMgNtnEfQzDKpLXYhgo3W3Gndl34gITqmP914zSwhajIEJzUPpx40P7R8fRe1QmicneQMhFzpZNhSLjrvU1pIA/0?wx_fmt=jpeg\",\"http://mmbiz.qpic.cn/mmbiz_jpg/kKMgNtnEfQzDKpLXYhgo3W3Gndl34gITRneE5FS9uYruXGMmrtmhsBySwddEWUGOibG8Ze2NT5E3Dyt79I0htNg/0?wx_fmt=jpeg\"]}",
"service_infos": "{\"service_infos\":[{\"id\":2,\"type\":1,\"name\":\"快遞\",\"appid\":\"wx1373169e494e0c39\",\"path\":\"index\"},{\"id\":0,\"type\":2,\"name\":\"自定義\",\"appid\":\"wx1373169e494e0c39\",\"path\":\"index\"}]}",
"store_name": "羊村小馬燒烤",
"contract_phone": "111111111",
"hour": "00:00-11:11",
"company_name": "深圳市騰訊計(jì)算機(jī)系統(tǒng)有限公司",
"credential": "156718193518281",
"address": "新疆維吾爾自治區(qū)克拉瑪依市克拉瑪依區(qū)碧水路15-1-8號(hào)(碧水云天廣場(chǎng))",
"qualification_list": "3LaLzqiTrQcD20DlX_o-OV1-nlYMu7sdVAL7SV2PrxVyjZFZZmB3O6LPGaYXlZWq",
"poi_id": ""
}
返回json示例： { "errcode":0, "errmsg":"ok", "data":{ "audit_id":416620525, "poi_id": 112333 } }
審核狀態(tài)通知
審核狀態(tài)通過事件推送通知，推送數(shù)據(jù)格式為 XML
示例數(shù)據(jù)
1488856741
11111
3 // 2: 審核失敗 3: 審核通過
111111
參數(shù)說明
| 參數(shù) | 說明 |
|---|---|
| audit_id | 審核單id |
| status | 審核狀態(tài)（3：審核通過，2：審核失?。?/td> |
| reason | 如果status為2，會(huì)返回審核失敗的原因 |
| poi_id | poi_id |
云調(diào)用
云調(diào)用是小程序·云開發(fā)提供的在云函數(shù)中調(diào)用微信開放接口的能力，需要在云函數(shù)中通過 wx-server-sdk 使用。
接口方法
openapi.nearbyPoi.add
需在 config.json 中配置 nearbyPoi.add API 的權(quán)限， 詳情
請(qǐng)求參數(shù)
| 屬性 | 類型 | 默認(rèn)值 | 必填 | 說明 |
|---|---|---|---|---|
| isCommNearby | string | 是 | 必填,寫死為"1" | |
| picList | string | 是 | 門店圖片，最多9張，最少1張，上傳門店圖片如門店外景、環(huán)境設(shè)施、商品服務(wù)等，圖片將展示在微信客戶端的門店頁。圖片鏈接通過文檔https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1444738729中的《上傳圖文消息內(nèi)的圖片獲取URL》接口獲取。必填，文件格式為bmp、png、jpeg、jpg或gif，大小不超過5M pic_list是字符串，內(nèi)容是一個(gè)json | |
| serviceInfos | string | 是 | 必服務(wù)標(biāo)簽列表 必填，需要填寫 1、 服務(wù)標(biāo)簽ID 2、 服務(wù)類型tpye 3、 服務(wù)名稱name 詳細(xì)字段格式見下方《服務(wù)標(biāo)簽id編號(hào)、類型與服務(wù)名稱表》 4、 APPID 5、 對(duì)應(yīng)服務(wù)落地頁的path路徑：path路徑頁面要與對(duì)應(yīng)的服務(wù)標(biāo)簽一致，例如選取外賣服務(wù)，path路徑應(yīng)該是小程序的外賣對(duì)應(yīng)的那個(gè)頁面，path路徑獲取咨詢開發(fā)或者到小程序管理后臺(tái)-工具-生成小程序碼頁面獲取 6、新增服務(wù)描述desc：描述服務(wù)內(nèi)容，例如滿減、折扣等優(yōu)惠信息或新品、爆品等商品信息，僅標(biāo)準(zhǔn)服務(wù)都可添加，10個(gè)字符以內(nèi)。 service_infos是字符串，內(nèi)容是一個(gè)json | |
| kfInfo | string | 是 | 客服信息 選填，可自定義服務(wù)頭像與昵稱，具體填寫字段見下方示例kf_info pic_list是字符串，內(nèi)容是一個(gè)json | |
| storeName | string | 是 | 門店名字 必填，門店名稱需按照所選地理位置自動(dòng)拉取騰訊地圖門店名稱，不可修改，如需修改請(qǐng)重現(xiàn)選擇地圖地點(diǎn)或重新創(chuàng)建地點(diǎn)。 | |
| hour | string | 是 | 營(yíng)業(yè)時(shí)間，格式11:11-12:12 必填 | |
| address | string | 是 | 地址 必填 | |
| poiId | string | 是 | 如果創(chuàng)建新的門店，poi_id字段為空 如果更新門店，poi_id參數(shù)則填對(duì)應(yīng)門店的poi_id 選填 | |
| companyName | string | 是 | 主體名字 必填 | |
| contractPhone | string | 是 | 門店電話 必填 | |
| credential | string | 是 | 資質(zhì)號(hào) 必填, 15位營(yíng)業(yè)執(zhí)照注冊(cè)號(hào)或9位組織機(jī)構(gòu)代碼 | |
| qualificationList | string | 是 | 證明材料 必填 如果company_name和該小程序主體不一致，需要填qualification_list，詳細(xì)規(guī)則見附近的小程序使用指南-如何證明門店的經(jīng)營(yíng)主體跟公眾號(hào)或小程序帳號(hào)主體相關(guān)http://kf.qq.com/faq/170401MbUnim17040122m2qY.html | |
| mapPoiId | string | 是 | 對(duì)應(yīng)《在騰訊地圖中搜索門店》中的sosomap_poi_uid字段 騰訊地圖那邊有些數(shù)據(jù)不一致，如果不填map_poi_id的話，小概率會(huì)提交失??！ 注： poi_id與map_poi_id關(guān)系： map_poi_id是騰訊地圖對(duì)于poi的唯一標(biāo)識(shí) poi_id是門店進(jìn)駐附近后的門店唯一標(biāo)識(shí) | |
| NearbyPoiError@error |
返回值
Object
返回的 JSON 數(shù)據(jù)包
| 屬性 | 類型 | 說明 |
|---|---|---|
| errMsg | string | 錯(cuò)誤信息 |
| errCode | number | 錯(cuò)誤碼 |
| data | object | 返回?cái)?shù)據(jù) |
data 的結(jié)構(gòu)
| 屬性 | 類型 | 說明 |
|---|---|---|
| auditId | string | 審核單 ID |
| poiId | string | 附近地點(diǎn) ID |
| relatedCredential | string | 經(jīng)營(yíng)資質(zhì)證件號(hào) |
異常
Object
拋出的異常
| 屬性 | 類型 | 說明 |
|---|---|---|
| errMsg | string | 錯(cuò)誤信息 |
| errCode | number | 錯(cuò)誤碼 |
errCode 的合法值
| 值 | 說明 | 最低版本 |
|---|
請(qǐng)求示例
{
"is_comm_nearby": "1", //值固定
"kf_info": "{\"open_kf\":true,\"kf_headimg\":\"http://mmbiz.qpic.cn/mmbiz_jpg/kKMgNtnEfQzDKpLXYhgo3W3Gndl34gITqmP914zSwhajIEJzUPpx40P7R8fRe1QmicneQMhFzpZNhSLjrvU1pIA/0?wx_fmt=jpeg\",\"kf_name\":\"Harden\"}",
"pic_list": "{\"list\":[\"http://mmbiz.qpic.cn/mmbiz_jpg/kKMgNtnEfQzDKpLXYhgo3W3Gndl34gITqmP914zSwhajIEJzUPpx40P7R8fRe1QmicneQMhFzpZNhSLjrvU1pIA/0?wx_fmt=jpeg\",\"http://mmbiz.qpic.cn/mmbiz_jpg/kKMgNtnEfQzDKpLXYhgo3W3Gndl34gITRneE5FS9uYruXGMmrtmhsBySwddEWUGOibG8Ze2NT5E3Dyt79I0htNg/0?wx_fmt=jpeg\"]}",
"service_infos": "{\"service_infos\":[{\"id\":2,\"type\":1,\"name\":\"快遞\",\"appid\":\"wx1373169e494e0c39\",\"path\":\"index\"},{\"id\":0,\"type\":2,\"name\":\"自定義\",\"appid\":\"wx1373169e494e0c39\",\"path\":\"index\"}]}",
"store_name": "羊村小馬燒烤",
"contract_phone": "111111111",
"hour": "00:00-11:11",
"company_name": "深圳市騰訊計(jì)算機(jī)系統(tǒng)有限公司",
"credential": "156718193518281",
"address": "新疆維吾爾自治區(qū)克拉瑪依市克拉瑪依區(qū)碧水路15-1-8號(hào)(碧水云天廣場(chǎng))",
"qualification_list": "3LaLzqiTrQcD20DlX_o-OV1-nlYMu7sdVAL7SV2PrxVyjZFZZmB3O6LPGaYXlZWq",
"poi_id": ""
}
返回json示例： { "errcode":0, "errmsg":"ok", "data":{ "audit_id":416620525, "poi_id": 112333 } }
當(dāng)前文章：創(chuàng)新互聯(lián)小程序教程：微信小程序 add
文章起源：http://www.fisionsoft.com.cn/article/djgeggc.html
