W3Cschool
恭喜您成為首批注冊用戶
獲得88經(jīng)驗值獎勵
本接口應在服務器端調用,詳細說明參見服務端API。
本接口支持云調用。需開發(fā)者工具版本 >= 1.02.1904090(最新穩(wěn)定版下載)
wx-server-sdk >= 0.4.0
添加地點
調用方式:
POST https://api.weixin.qq.com/wxa/addnearbypoi?access_token=ACCESS_TOKEN
屬性 | 類型 | 默認值 | 必填 | 說明 |
---|---|---|---|---|
access_token | string | 是 | 接口調用憑證 | |
is_comm_nearby | string | 是 | 必填,寫死為"1" | |
pic_list | string | 是 | 門店圖片,最多9張,最少1張,上傳門店圖片如門店外景、環(huán)境設施、商品服務等,圖片將展示在微信客戶端的門店頁。圖片鏈接通過文檔https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1444738729中的《上傳圖文消息內的圖片獲取URL》接口獲取。必填,文件格式為bmp、png、jpeg、jpg或gif,大小不超過5M pic_list是字符串,內容是一個json | |
service_infos | string | 是 | 必服務標簽列表 必填,需要填寫
1、 服務標簽ID 2、 服務類型tpye 3、 服務名稱name 詳細字段格式見下方《服務標簽id編號、類型與服務名稱表》 4、 APPID 5、 對應服務落地頁的path路徑:path路徑頁面要與對應的服務標簽一致,例如選取外賣服務,path路徑應該是小程序的外賣對應的那個頁面,path路徑獲取咨詢開發(fā)或者到小程序管理后臺-工具-生成小程序碼頁面獲取 6、新增服務描述desc:描述服務內容,例如滿減、折扣等優(yōu)惠信息或新品、爆品等商品信息,僅標準服務都可添加,10個字符以內。 service_infos是字符串,內容是一個json |
|
kf_info | string | 是 | 客服信息 選填,可自定義服務頭像與昵稱,具體填寫字段見下方示例kf_info pic_list是字符串,內容是一個json | |
store_name | string | 是 | 門店名字 必填,門店名稱需按照所選地理位置自動拉取騰訊地圖門店名稱,不可修改,如需修改請重現(xiàn)選擇地圖地點或重新創(chuàng)建地點。 | |
hour | string | 是 | 營業(yè)時間,格式11:11-12:12 必填 | |
address | string | 是 | 地址 必填 | |
poi_id | string | 是 | 如果創(chuàng)建新的門店,poi_id字段為空 如果更新門店,poi_id參數(shù)則填對應門店的poi_id 選填 | |
company_name | string | 是 | 主體名字 必填 | |
contract_phone | string | 是 | 門店電話 必填 | |
credential | string | 是 | 資質號 必填, 15位營業(yè)執(zhí)照注冊號或9位組織機構代碼 | |
qualification_list | string | 是 | 證明材料 必填 如果company_name和該小程序主體不一致,需要填qualification_list,詳細規(guī)則見附近的小程序使用指南-如何證明門店的經(jīng)營主體跟公眾號或小程序帳號主體相關http://kf.qq.com/faq/170401MbUnim17040122m2qY.html | |
map_poi_id | string | 是 | 對應《在騰訊地圖中搜索門店》中的sosomap_poi_uid字段 騰訊地圖那邊有些數(shù)據(jù)不一致,如果不填map_poi_id的話,小概率會提交失??!
注: poi_id與map_poi_id關系: map_poi_id是騰訊地圖對于poi的唯一標識 poi_id是門店進駐附近后的門店唯一標識 |
|
NearbyPoiError@error |
返回的 JSON 數(shù)據(jù)包
屬性 | 類型 | 說明 |
---|---|---|
errmsg | string | 錯誤信息 |
errcode | number | 錯誤碼 |
data | object | 返回數(shù)據(jù) |
data 的結構
屬性 | 類型 | 說明 |
---|---|---|
audit_id | string | 審核單 ID |
poi_id | string | 附近地點 ID |
related_credential | string | 經(jīng)營資質證件號 |
注:添加門店需要審核,需要1到2個工作日
ID | type | name(服務名稱) |
---|---|---|
0 | 2 | 自定義服務,可自定義名稱(10個以內) |
1 | 1 | 外送 |
2 | 1 | 快遞 |
3 | 1 | 充電 |
4 | 1 | 預約 |
5 | 1 | 掛號 |
6 | 1 | 點餐 |
7 | 1 | 優(yōu)惠 |
8 | 1 | 乘車 |
9 | 1 | 會員 |
10 | 1 | 買單 |
11 | 1 | 排隊 |
12 | 1 | 繳費 |
13 | 1 | 購票 |
14 | 1 | 到店自提 |
15 | 1 | 預定 |
添加請求暫不支持并發(fā)調用,建議使用時間隔1s進行串行調用
{
"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": "深圳市騰訊計算機系統(tǒng)有限公司",
"credential": "156718193518281",
"address": "新疆維吾爾自治區(qū)克拉瑪依市克拉瑪依區(qū)碧水路15-1-8號(碧水云天廣場)",
"qualification_list": "3LaLzqiTrQcD20DlX_o-OV1-nlYMu7sdVAL7SV2PrxVyjZFZZmB3O6LPGaYXlZWq",
"poi_id": ""
}
返回json示例: { "errcode":0, "errmsg":"ok", "data":{ "audit_id":416620525, "poi_id": 112333 } }
審核狀態(tài)通過事件推送通知,推送數(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: 審核通過
<reason><![CDATA[xxx]]></reason> //審核失敗的理由
<poi_id>111111</poi_id>
</xml>
參數(shù) | 說明 |
---|---|
audit_id | 審核單id |
status | 審核狀態(tài)(3:審核通過,2:審核失?。?/td> |
reason | 如果status為2,會返回審核失敗的原因 |
poi_id | poi_id |
云調用是小程序·云開發(fā)提供的在云函數(shù)中調用微信開放接口的能力,需要在云函數(shù)中通過 wx-server-sdk 使用。
openapi.nearbyPoi.add
需在 config.json 中配置 nearbyPoi.add API 的權限,詳情
屬性 | 類型 | 默認值 | 必填 | 說明 |
---|---|---|---|---|
isCommNearby | string | 是 | 必填,寫死為"1" | |
picList | string | 是 | 門店圖片,最多9張,最少1張,上傳門店圖片如門店外景、環(huán)境設施、商品服務等,圖片將展示在微信客戶端的門店頁。圖片鏈接通過文檔https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1444738729中的《上傳圖文消息內的圖片獲取URL》接口獲取。必填,文件格式為bmp、png、jpeg、jpg或gif,大小不超過5M pic_list是字符串,內容是一個json | |
serviceInfos | string | 是 | 必服務標簽列表 必填,需要填寫
1、 服務標簽ID 2、 服務類型tpye 3、 服務名稱name 詳細字段格式見下方《服務標簽id編號、類型與服務名稱表》 4、 APPID 5、 對應服務落地頁的path路徑:path路徑頁面要與對應的服務標簽一致,例如選取外賣服務,path路徑應該是小程序的外賣對應的那個頁面,path路徑獲取咨詢開發(fā)或者到小程序管理后臺-工具-生成小程序碼頁面獲取 6、新增服務描述desc:描述服務內容,例如滿減、折扣等優(yōu)惠信息或新品、爆品等商品信息,僅標準服務都可添加,10個字符以內。 service_infos是字符串,內容是一個json |
|
kfInfo | string | 是 | 客服信息 選填,可自定義服務頭像與昵稱,具體填寫字段見下方示例kf_info pic_list是字符串,內容是一個json | |
storeName | string | 是 | 門店名字 必填,門店名稱需按照所選地理位置自動拉取騰訊地圖門店名稱,不可修改,如需修改請重現(xiàn)選擇地圖地點或重新創(chuàng)建地點。 | |
hour | string | 是 | 營業(yè)時間,格式11:11-12:12 必填 | |
address | string | 是 | 地址 必填 | |
poiId | string | 是 | 如果創(chuàng)建新的門店,poi_id字段為空 如果更新門店,poi_id參數(shù)則填對應門店的poi_id 選填 | |
companyName | string | 是 | 主體名字 必填 | |
contractPhone | string | 是 | 門店電話 必填 | |
credential | string | 是 | 資質號 必填, 15位營業(yè)執(zhí)照注冊號或9位組織機構代碼 | |
qualificationList | string | 是 | 證明材料 必填 如果company_name和該小程序主體不一致,需要填qualification_list,詳細規(guī)則見附近的小程序使用指南-如何證明門店的經(jīng)營主體跟公眾號或小程序帳號主體相關http://kf.qq.com/faq/170401MbUnim17040122m2qY.html | |
mapPoiId | string | 是 | 對應《在騰訊地圖中搜索門店》中的sosomap_poi_uid字段 騰訊地圖那邊有些數(shù)據(jù)不一致,如果不填map_poi_id的話,小概率會提交失??!
注: poi_id與map_poi_id關系: map_poi_id是騰訊地圖對于poi的唯一標識 poi_id是門店進駐附近后的門店唯一標識 |
|
NearbyPoiError@error |
返回的 JSON 數(shù)據(jù)包
屬性 | 類型 | 說明 |
---|---|---|
errMsg | string | 錯誤信息 |
errCode | number | 錯誤碼 |
data | object | 返回數(shù)據(jù) |
data 的結構
屬性 | 類型 | 說明 |
---|---|---|
auditId | string | 審核單 ID |
poiId | string | 附近地點 ID |
relatedCredential | string | 經(jīng)營資質證件號 |
拋出的異常
屬性 | 類型 | 說明 |
---|---|---|
errMsg | string | 錯誤信息 |
errCode | number | 錯誤碼 |
errCode 的合法值
值 | 說明 | 最低版本 |
---|
{
"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": "深圳市騰訊計算機系統(tǒng)有限公司",
"credential": "156718193518281",
"address": "新疆維吾爾自治區(qū)克拉瑪依市克拉瑪依區(qū)碧水路15-1-8號(碧水云天廣場)",
"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號-3|閩公網(wǎng)安備35020302033924號
違法和不良信息舉報電話:173-0602-2364|舉報郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號
聯(lián)系方式:
更多建議: