微信小程序 add

2020-07-31 14:03 更新

nearbyPoi.add

本接口應(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)用方式:

  • 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ù)

屬性 類(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

返回值

Object

返回的 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è)工作日

服務(wù)標(biāo)簽id編號(hào)、類(lèi)型與服務(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 乘車(chē)
9 1 會(huì)員
10 1 買(mǎi)單
11 1 排隊(duì)
12 1 繳費(fèi)
13 1 購(gòu)票
14 1 到店自提
15 1 預(yù)定

頻率限制說(shuō)明

添加請(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)通過(guò)事件推送通知,推送數(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: 審核通過(guò)
  <reason><![CDATA[xxx]]></reason>  //審核失敗的理由
  <poi_id>111111</poi_id>
</xml>

參數(shù)說(shuō)明

參數(shù) 說(shuō)明
audit_id 審核單id
status 審核狀態(tài)(3:審核通過(guò),2:審核失?。?/td>
reason 如果status為2,會(huì)返回審核失敗的原因
poi_id poi_id

云調(diào)用

云調(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)限,詳情

請(qǐng)求參數(shù)

屬性 類(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

返回值

Object

返回的 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)

異常

Object

拋出的異常

屬性 類(lèi)型 說(shuō)明
errMsg string 錯(cuò)誤信息
errCode number 錯(cuò)誤碼

errCode 的合法值

說(shuō)明 最低版本

請(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 } }


以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)