微信小程序 add

2020-07-31 14:03 更新

nearbyPoi.add

本接口應在服務器端調用,詳細說明參見服務端API
本接口支持云調用。需開發(fā)者工具版本 >= 1.02.1904090(最新穩(wěn)定版下載
wx-server-sdk >= 0.4.0

添加地點

調用方式:

  • HTTPS 調用
  • 云調用

HTTPS 調用

請求地址

POST https://api.weixin.qq.com/wxa/addnearbypoi?access_token=ACCESS_TOKEN

請求參數(shù)

屬性 類型 默認值 必填 說明
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

返回值

Object

返回的 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編號、類型與服務名稱表

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)通知

審核狀態(tài)通過事件推送通知,推送數(shù)據(jù)格式為 XML

示例數(shù)據(jù)

<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ù)說明

參數(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 的權限,詳情

請求參數(shù)

屬性 類型 默認值 必填 說明
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

返回值

Object

返回的 JSON 數(shù)據(jù)包

屬性 類型 說明
errMsg string 錯誤信息
errCode number 錯誤碼
data object 返回數(shù)據(jù)

data 的結構

屬性 類型 說明
auditId string 審核單 ID
poiId string 附近地點 ID
relatedCredential string 經(jīng)營資質證件號

異常

Object

拋出的異常

屬性 類型 說明
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 } }


以上內容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號