W3Cschool
恭喜您成為首批注冊(cè)用戶
獲得88經(jīng)驗(yàn)值獎(jiǎng)勵(lì)
本接口應(yīng)在服務(wù)器端調(diào)用,詳細(xì)說(shuō)明參見(jiàn)服務(wù)端API。
本接口支持云調(diào)用。需開(kāi)發(fā)者工具版本 >= 1.02.1904090(最新穩(wěn)定版下載)
wx-server-sdk >= 0.4.0
添加地點(diǎn)
調(diào)用方式:
POST https://api.weixin.qq.com/wxa/addnearbypoi?access_token=ACCESS_TOKEN
屬性 | 類(lèi)型 | 默認(rèn)值 | 必填 | 說(shuō)明 |
---|---|---|---|---|
access_token | string | 是 | 接口調(diào)用憑證 | |
is_comm_nearby | string | 是 | 必填,寫(xiě)死為"1" | |
pic_list | string | 是 | 門(mén)店圖片,最多9張,最少1張,上傳門(mén)店圖片如門(mén)店外景、環(huán)境設(shè)施、商品服務(wù)等,圖片將展示在微信客戶端的門(mén)店頁(yè)。圖片鏈接通過(guò)文檔https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1444738729中的《上傳圖文消息內(nèi)的圖片獲取URL》接口獲取。必填,文件格式為bmp、png、jpeg、jpg或gif,大小不超過(guò)5M pic_list是字符串,內(nèi)容是一個(gè)json | |
service_infos | string | 是 | 必服務(wù)標(biāo)簽列表 必填,需要填寫(xiě)
1、 服務(wù)標(biāo)簽ID 2、 服務(wù)類(lèi)型tpye 3、 服務(wù)名稱name 詳細(xì)字段格式見(jiàn)下方《服務(wù)標(biāo)簽id編號(hào)、類(lèi)型與服務(wù)名稱表》 4、 APPID 5、 對(duì)應(yīng)服務(wù)落地頁(yè)的path路徑:path路徑頁(yè)面要與對(duì)應(yīng)的服務(wù)標(biāo)簽一致,例如選取外賣(mài)服務(wù),path路徑應(yīng)該是小程序的外賣(mài)對(duì)應(yīng)的那個(gè)頁(yè)面,path路徑獲取咨詢開(kāi)發(fā)或者到小程序管理后臺(tái)-工具-生成小程序碼頁(yè)面獲取 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ù)頭像與昵稱,具體填寫(xiě)字段見(jiàn)下方示例kf_info pic_list是字符串,內(nèi)容是一個(gè)json | |
store_name | string | 是 | 門(mén)店名字 必填,門(mén)店名稱需按照所選地理位置自動(dòng)拉取騰訊地圖門(mén)店名稱,不可修改,如需修改請(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)建新的門(mén)店,poi_id字段為空 如果更新門(mén)店,poi_id參數(shù)則填對(duì)應(yīng)門(mén)店的poi_id 選填 | |
company_name | string | 是 | 主體名字 必填 | |
contract_phone | string | 是 | 門(mén)店電話 必填 | |
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ī)則見(jiàn)附近的小程序使用指南-如何證明門(mén)店的經(jīng)營(yíng)主體跟公眾號(hào)或小程序帳號(hào)主體相關(guān)http://kf.qq.com/faq/170401MbUnim17040122m2qY.html | |
map_poi_id | string | 是 | 對(duì)應(yīng)《在騰訊地圖中搜索門(mén)店》中的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是門(mén)店進(jìn)駐附近后的門(mén)店唯一標(biāo)識(shí) |
|
NearbyPoiError@error |
返回的 JSON 數(shù)據(jù)包
屬性 | 類(lèi)型 | 說(shuō)明 |
---|---|---|
errmsg | string | 錯(cuò)誤信息 |
errcode | number | 錯(cuò)誤碼 |
data | object | 返回?cái)?shù)據(jù) |
data 的結(jié)構(gòu)
屬性 | 類(lèi)型 | 說(shuō)明 |
---|---|---|
audit_id | string | 審核單 ID |
poi_id | string | 附近地點(diǎn) ID |
related_credential | string | 經(jīng)營(yíng)資質(zhì)證件號(hào) |
注:添加門(mén)店需要審核,需要1到2個(gè)工作日
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 | 乘車(chē) |
9 | 1 | 會(huì)員 |
10 | 1 | 買(mǎi)單 |
11 | 1 | 排隊(duì) |
12 | 1 | 繳費(fèi) |
13 | 1 | 購(gòu)票 |
14 | 1 | 到店自提 |
15 | 1 | 預(yù)定 |
添加請(qǐng)求暫不支持并發(fā)調(diào)用,建議使用時(shí)間隔1s進(jìn)行串行調(diào)用
{
"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)通過(guò)事件推送通知,推送數(shù)據(jù)格式為 XML
<xml>
<ToUserName><![CDATA[gh_4346ac1514d8]]></ToUserName>
<FromUserName><![CDATA[od1P50M-fNQI5Gcq-trm4a7apsU8]]></FromUserName>
<CreateTime>1488856741</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[add_nearby_poi_audit_info]]></Event>
<audit_id>11111</audit_id>
<status>3</status> // 2: 審核失敗 3: 審核通過(guò)
<reason><![CDATA[xxx]]></reason> //審核失敗的理由
<poi_id>111111</poi_id>
</xml>
參數(shù) | 說(shuō)明 |
---|---|
audit_id | 審核單id |
status | 審核狀態(tài)(3:審核通過(guò),2:審核失?。?/td> |
reason | 如果status為2,會(huì)返回審核失敗的原因 |
poi_id | poi_id |
云調(diào)用是小程序·云開(kāi)發(fā)提供的在云函數(shù)中調(diào)用微信開(kāi)放接口的能力,需要在云函數(shù)中通過(guò) wx-server-sdk 使用。
openapi.nearbyPoi.add
需在 config.json 中配置 nearbyPoi.add API 的權(quán)限,詳情
屬性 | 類(lèi)型 | 默認(rèn)值 | 必填 | 說(shuō)明 |
---|---|---|---|---|
isCommNearby | string | 是 | 必填,寫(xiě)死為"1" | |
picList | string | 是 | 門(mén)店圖片,最多9張,最少1張,上傳門(mén)店圖片如門(mén)店外景、環(huán)境設(shè)施、商品服務(wù)等,圖片將展示在微信客戶端的門(mén)店頁(yè)。圖片鏈接通過(guò)文檔https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1444738729中的《上傳圖文消息內(nèi)的圖片獲取URL》接口獲取。必填,文件格式為bmp、png、jpeg、jpg或gif,大小不超過(guò)5M pic_list是字符串,內(nèi)容是一個(gè)json | |
serviceInfos | string | 是 | 必服務(wù)標(biāo)簽列表 必填,需要填寫(xiě)
1、 服務(wù)標(biāo)簽ID 2、 服務(wù)類(lèi)型tpye 3、 服務(wù)名稱name 詳細(xì)字段格式見(jiàn)下方《服務(wù)標(biāo)簽id編號(hào)、類(lèi)型與服務(wù)名稱表》 4、 APPID 5、 對(duì)應(yīng)服務(wù)落地頁(yè)的path路徑:path路徑頁(yè)面要與對(duì)應(yīng)的服務(wù)標(biāo)簽一致,例如選取外賣(mài)服務(wù),path路徑應(yīng)該是小程序的外賣(mài)對(duì)應(yīng)的那個(gè)頁(yè)面,path路徑獲取咨詢開(kāi)發(fā)或者到小程序管理后臺(tái)-工具-生成小程序碼頁(yè)面獲取 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ù)頭像與昵稱,具體填寫(xiě)字段見(jiàn)下方示例kf_info pic_list是字符串,內(nèi)容是一個(gè)json | |
storeName | string | 是 | 門(mén)店名字 必填,門(mén)店名稱需按照所選地理位置自動(dòng)拉取騰訊地圖門(mén)店名稱,不可修改,如需修改請(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)建新的門(mén)店,poi_id字段為空 如果更新門(mén)店,poi_id參數(shù)則填對(duì)應(yīng)門(mén)店的poi_id 選填 | |
companyName | string | 是 | 主體名字 必填 | |
contractPhone | string | 是 | 門(mén)店電話 必填 | |
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ī)則見(jiàn)附近的小程序使用指南-如何證明門(mén)店的經(jīng)營(yíng)主體跟公眾號(hào)或小程序帳號(hào)主體相關(guān)http://kf.qq.com/faq/170401MbUnim17040122m2qY.html | |
mapPoiId | string | 是 | 對(duì)應(yīng)《在騰訊地圖中搜索門(mén)店》中的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是門(mén)店進(jìn)駐附近后的門(mén)店唯一標(biāo)識(shí) |
|
NearbyPoiError@error |
返回的 JSON 數(shù)據(jù)包
屬性 | 類(lèi)型 | 說(shuō)明 |
---|---|---|
errMsg | string | 錯(cuò)誤信息 |
errCode | number | 錯(cuò)誤碼 |
data | object | 返回?cái)?shù)據(jù) |
data 的結(jié)構(gòu)
屬性 | 類(lèi)型 | 說(shuō)明 |
---|---|---|
auditId | string | 審核單 ID |
poiId | string | 附近地點(diǎn) ID |
relatedCredential | string | 經(jīng)營(yíng)資質(zhì)證件號(hào) |
拋出的異常
屬性 | 類(lèi)型 | 說(shuō)明 |
---|---|---|
errMsg | string | 錯(cuò)誤信息 |
errCode | number | 錯(cuò)誤碼 |
errCode 的合法值
值 | 說(shuō)明 | 最低版本 |
---|
{
"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 } }
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)系方式:
更多建議: