国产av日韩一区二区三区精品,成人性爱视频在线观看,国产,欧美,日韩,一区,www.成色av久久成人,2222eeee成人天堂

微信門(mén)店接口

微信門(mén)店接口

1475117517917178.png

更新日志:

版本號(hào)更新內(nèi)容更新時(shí)間
V2.1創(chuàng)建門(mén)店可以返回臨時(shí)poiid2016.7.18

微信門(mén)店接口文檔

1.接口簡(jiǎn)介

門(mén)店管理接口為商戶(hù)提供門(mén)店批量導(dǎo)入、查詢(xún)、修改、刪除等主要功能,方便商戶(hù)快速、高效進(jìn)行門(mén)店管理和操作。

商戶(hù)在使用門(mén)店管理接口時(shí)需注意以下幾個(gè)問(wèn)題:

門(mén)店信息全部需要經(jīng)過(guò)審核方能生效,門(mén)店創(chuàng)建完成后,獲得poi_id,但該id不一定為最終id,在審核通過(guò)后id可能發(fā)生變化,只有收到微信推送的審核結(jié)果通知中的poi_id才為最終id,并使用在微信各個(gè)業(yè)務(wù)場(chǎng)景中(若在審核期間使用臨時(shí)poi_id造成相應(yīng)影響,由開(kāi)發(fā)者自身承擔(dān));

為保證在審核通過(guò)后,獲取到的poi_id 能與商戶(hù)自身數(shù)據(jù)做對(duì)應(yīng),將會(huì)允許商戶(hù)在創(chuàng)建時(shí)提交自己內(nèi)部或自定義的sid(字符串格式,微信不會(huì)對(duì)唯一性進(jìn)行校驗(yàn),請(qǐng)商戶(hù)自己保證),用于后續(xù)獲取poi_id 后對(duì)數(shù)據(jù)進(jìn)行對(duì)應(yīng);

門(mén)店的可用狀態(tài)available_state,將標(biāo)記門(mén)店相應(yīng)審核狀態(tài),只有審核通過(guò)狀態(tài),才能進(jìn)行更新,更新字段僅限擴(kuò)展字段(表1 中前11 個(gè)字段);

擴(kuò)展字段屬于公共編輯信息,提交更新后將由微信進(jìn)行審核采納,但擴(kuò)展字段更新并不影響門(mén)店的可用狀態(tài)(即available_state 仍為審核通過(guò)),但update_status 狀態(tài)變?yōu)?,更新中狀態(tài),此時(shí)不可再次對(duì)門(mén)店進(jìn)行更新,直到微信審核采納后;

在update_status 為1,更新中狀態(tài)下的門(mén)店,此時(shí)調(diào)用getpoi 接口,獲取到的擴(kuò)展字段為更新的最新字段,但并不是最終結(jié)果,仍需等待微信編輯對(duì)擴(kuò)展字段的建議進(jìn)行采納后,最終決定是否生效(有可能更新字段不被采納);

門(mén)店頁(yè)面示例

1476414213780225.jpg

2.開(kāi)發(fā)者必讀

2.1申請(qǐng)接入

擁有已認(rèn)證的服務(wù)號(hào)可申請(qǐng)開(kāi)通門(mén)店管理功能。

認(rèn)證的訂閱號(hào)擁有卡券、WI-FI、搖一搖、廣告主等功能后會(huì)自動(dòng)開(kāi)通門(mén)店管理功能。

申請(qǐng)路徑如下登錄微信公眾平臺(tái)—添加功能插件—選擇門(mén)店功能。

2.2開(kāi)發(fā)流程

獲取接口權(quán)限后,商戶(hù)開(kāi)發(fā)者需按照以下步驟開(kāi)發(fā)和調(diào)試,請(qǐng)開(kāi)發(fā)者務(wù)必仔細(xì)閱讀以下流程!

1、創(chuàng)建門(mén)店前的準(zhǔn)備

上傳圖片:上傳商戶(hù)新建門(mén)店時(shí)所使用的圖片。上傳的圖片url必須為微信自己域名的url。

2.創(chuàng)建門(mén)店

調(diào)用創(chuàng)建門(mén)店接口,調(diào)用成功后返回errcode、errmsg,會(huì)返回臨時(shí)poi_id,該id可能與最終id不同。

3.審核結(jié)果事件推送

新創(chuàng)建的門(mén)店在審核通過(guò)后,會(huì)以事件形式推送給商戶(hù)填寫(xiě)的回調(diào)url(登陸公眾平臺(tái)進(jìn)入“開(kāi)發(fā)者中心”設(shè)置)審核通過(guò)獲取門(mén)店唯一id:poi_id。

審核結(jié)果事件推送

4.查詢(xún)門(mén)店信息

在審核通過(guò)并獲取poi_id 后,商戶(hù)可以利用poi_id,查詢(xún)具體某條門(mén)店的信息。

5.查詢(xún)門(mén)店列表

商戶(hù)可以通過(guò)該接口,批量查詢(xún)自己名下的門(mén)店list,并獲取已審核通過(guò)的poi_id以及商戶(hù)自身用于對(duì)應(yīng)、商戶(hù)名、分店名、地址字段的sid

6.修改門(mén)店服務(wù)信息

商戶(hù)可以通過(guò)該接口,修改門(mén)店的服務(wù)信息,包括:圖片列表、營(yíng)業(yè)時(shí)間、推薦、特色服務(wù)、簡(jiǎn)介、人均價(jià)格、電話(huà)7 個(gè)字段(名稱(chēng)、坐標(biāo)、地址等不可修改)修改后需要人工審核。

7.刪除門(mén)店

商戶(hù)可以通過(guò)該接口,刪除已經(jīng)成功創(chuàng)建的門(mén)店。

注意:所有API接口POST的數(shù)據(jù)只支持UTF-8編碼,否則會(huì)返回報(bào)錯(cuò)。

3.創(chuàng)建門(mén)店

3.1上傳圖片

接口說(shuō)明

用POI 接口新建門(mén)店時(shí)所使用的圖片url 必須為微信域名的url,因此需要先用上傳圖片接口上傳圖片并獲取url,再創(chuàng)建門(mén)店。

上傳的圖片限制文件大小限制1MB,支持JPG 格式

接口調(diào)用請(qǐng)求說(shuō)明

協(xié)議https
http請(qǐng)求方式POST/FORM
請(qǐng)求Urlhttps://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN
POST數(shù)據(jù)格式buffer

請(qǐng)求參數(shù)說(shuō)明

參數(shù)說(shuō)明是否必填
access_token調(diào)用接口憑證
buffer圖片文件的數(shù)據(jù)流

返回?cái)?shù)據(jù)說(shuō)明

返回成功示例:

{

"url":"http://mmbiz.qpic.cn/XXXXX"

}

插入失敗示例(errcode 不為0,errmsg 為相應(yīng)錯(cuò)誤信息):

"errcode":40001,

"errmsg":"invalid credential"

}

字段說(shuō)明
errcode錯(cuò)誤碼,0為正常
errmsg錯(cuò)誤信息

3.2創(chuàng)建門(mén)店

接口說(shuō)明

創(chuàng)建門(mén)店接口是為商戶(hù)提供創(chuàng)建自己門(mén)店數(shù)據(jù)的接口,門(mén)店數(shù)據(jù)字段越完整,商戶(hù)頁(yè)面展示越豐富,越能夠吸引更多用戶(hù),并提高曝光度。

創(chuàng)建門(mén)店接口調(diào)用成功后會(huì)返回errcode 0、errmsg ok,但不會(huì)實(shí)時(shí)返回poi_id。

成功創(chuàng)建后,會(huì)生成poi_id,但該id不一定為最終id。門(mén)店信息會(huì)經(jīng)過(guò)審核,審核通過(guò)后方可獲取最終poi_id,該id為門(mén)店的唯一id,強(qiáng)烈建議自行存儲(chǔ)審核通過(guò)后的最終poi_id,并為后續(xù)調(diào)用使用。

接口調(diào)用請(qǐng)求說(shuō)明

協(xié)議https
http請(qǐng)求方式POST
請(qǐng)求Urlhttp://api.weixin.qq.com/cgi-bin/poi/addpoi?access_token=TOKEN
POST數(shù)據(jù)格式json

請(qǐng)求參數(shù)說(shuō)明

參數(shù)說(shuō)明是否必填
access_token調(diào)用接口憑證
bufferjson數(shù)據(jù)

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

字段視圖:

1476414270450770.png

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

{"business":{

   "base_info":{

                   "sid":"33788392",

                   "business_name":"15個(gè)漢字或30個(gè)英文字符內(nèi)",

                   "branch_name":"不超過(guò)10個(gè)字,不能含有括號(hào)和特殊字符",

                   "province":"不超過(guò)10個(gè)字",

                   "city":"不超過(guò)30個(gè)字",

                   "district":"不超過(guò)10個(gè)字",

                   "address":"門(mén)店所在的詳細(xì)街道地址(不要填寫(xiě)省市信息):不超過(guò)80個(gè)字",

                   "telephone":"不超53個(gè)字符(不可以出現(xiàn)文字)",

                   "categories":["美食,小吃快餐"], 

                   "offset_type":1,

                   "longitude":115.32375,

                   "latitude":25.097486,

                   "photo_list":[{"photo_url":"https:// 不超過(guò)20張.com"},{"photo_url":"https://XXX.com"}],

                   "recommend":"不超過(guò)200字。麥辣雞腿堡套餐,麥樂(lè)雞,全家桶",

                   "special":"不超過(guò)200字。免費(fèi)wifi,外賣(mài)服務(wù)",

                   "introduction":"不超過(guò)300字。麥當(dāng)勞是全球大型跨國(guó)連鎖餐廳,1940 年創(chuàng)立于美國(guó),在世界上

             大約擁有3 萬(wàn)間分店。主要售賣(mài)漢堡包,以及薯?xiàng)l、炸雞、汽水、冰品、沙拉、 水果等

             快餐食品",

                   "open_time":"8:00-20:00",

                   "avg_price":35

             }

    }

}

門(mén)店基礎(chǔ)信息字段(重要)

字段

說(shuō)明

是否必填

sid

商戶(hù)自己的id,用于后續(xù)審核通過(guò)收到poi_id 的通知時(shí),做對(duì)應(yīng)關(guān)系。請(qǐng)商戶(hù)自己保證唯一識(shí)別性

business_name

門(mén)店名稱(chēng)(僅為商戶(hù)名,如:國(guó)美、麥當(dāng)勞,不應(yīng)包含地區(qū)、地址、分店名等信息,錯(cuò)誤示例:北京國(guó)美)

不能為空,15個(gè)漢字或30個(gè)英文字符內(nèi)

branch_name

分店名稱(chēng)(不應(yīng)包含地區(qū)信息,不應(yīng)與門(mén)店名有重復(fù),錯(cuò)誤示例:北京王府井店)
10個(gè)字以?xún)?nèi)

province

門(mén)店所在的省份(直轄市填城市名,如:北京市)

10個(gè)字以?xún)?nèi)

city

門(mén)店所在的城市

10個(gè)字以?xún)?nèi)

district

門(mén)店所在地區(qū)

10個(gè)字以?xún)?nèi)

address

門(mén)店所在的詳細(xì)街道地址(不要填寫(xiě)省市信息)

(東莞等沒(méi)有“區(qū)”行政區(qū)劃的城市,該字段可不必填寫(xiě)。其余城市必填。)

telephone

門(mén)店的電話(huà)(純數(shù)字,區(qū)號(hào)、分機(jī)號(hào)均由“-”隔開(kāi))

categories

門(mén)店的類(lèi)型(不同級(jí)分類(lèi)用“,”隔開(kāi),如:美食,川菜,火鍋。詳細(xì)分類(lèi)參見(jiàn)附件:微信門(mén)店類(lèi)目表)

offset_type

坐標(biāo)類(lèi)型,1 為火星坐標(biāo)(目前只能選1)

longitude

門(mén)店所在地理位置的經(jīng)度

latitude

門(mén)店所在地理位置的緯度(經(jīng)緯度均為火星坐標(biāo),最好選用騰訊地圖標(biāo)記的坐標(biāo))

門(mén)店服務(wù)信息字段

字段

說(shuō)明

是否必填

photo_list

圖片列表,url 形式,可以有多張圖片,尺寸為

640*340px。必須為上一接口生成的url。圖片內(nèi)容不允許與門(mén)店不相關(guān),不允許為二維碼、員工合照(或模特肖像)、營(yíng)業(yè)執(zhí)照、無(wú)門(mén)店正門(mén)的街景、地圖截圖、公交地鐵站牌、菜單截圖等

recommend

推薦品,餐廳可為推薦菜;酒店為推薦套房;景點(diǎn)為推薦游玩景點(diǎn)等,針對(duì)自己行業(yè)的推薦內(nèi)容

200字以?xún)?nèi)

special

特色服務(wù),如免費(fèi)wifi,免費(fèi)停車(chē),送貨上門(mén)等商戶(hù)能提供的特色功能或服務(wù)

introduction

商戶(hù)簡(jiǎn)介,主要介紹商戶(hù)信息等

300字以?xún)?nèi)

open_time

營(yíng)業(yè)時(shí)間,24 小時(shí)制表示,用“-”連接,如

8:00-20:00

avg_price

人均價(jià)格,大于0 的整數(shù)

返回?cái)?shù)據(jù)

返回成功示例:

{

"errcode":0,

"errmsg":"ok"

}

插入失敗示例(errcode 不為0,errmsg 為相應(yīng)錯(cuò)誤信息):

{

"errcode":40001,

"errmsg":"invalid credential"

}

字段說(shuō)明
errcode錯(cuò)誤碼,0為正常
errmsg錯(cuò)誤信息

常見(jiàn)出錯(cuò)字段規(guī)范

1)門(mén)店名稱(chēng)

門(mén)店名:不能為空,15個(gè)漢字或30個(gè)英文字符內(nèi),不能含有括號(hào)和特殊字符,僅為商戶(hù)(品牌)名稱(chēng),如海底撈,蘇寧電器,華景國(guó)旅,茂業(yè)百貨;不應(yīng)包含地區(qū)、地址、分店名等信息。錯(cuò)誤及正確示例見(jiàn)下。

分店名:不超過(guò)10個(gè)字,不能含有括號(hào)和特殊字符,用于在同一商戶(hù)(品牌)有多家分店時(shí)區(qū)分不同門(mén)店,如國(guó)貿(mào)店,春熙路店,萬(wàn)象城店;不應(yīng)包含地區(qū)信息,不應(yīng)與門(mén)店名有重復(fù)。錯(cuò)誤及正確示例見(jiàn)下。

錯(cuò)誤示例1:

{"business":{

   "base_info":{

                   "sid":"33788392",

                 "business_name":"廣州東興堂大藥房連鎖有限公司永新分店",

                    "branch_name":"",

出錯(cuò)原因:把分店名寫(xiě)在了門(mén)店名中;包含了地區(qū)信息;包含了“連鎖有限公司”字樣

正確示例:

{"business":{

   "base_info":{

                   "sid":"33788392",

                "business_name":"東興堂大藥房",

                "branch_name":"永新分店",

錯(cuò)誤示例2:

{"business":{

   "base_info":{

                   "sid":"33788392",

                 "business_name":"山西國(guó)美",

                 "branch_name":"太原長(zhǎng)治路店",

出錯(cuò)原因:包含了地區(qū)信息

正確示例:

{"business":{

   "base_info":{

                   "sid":"33788392",

                 "business_name":"國(guó)美",

                 "branch_name":"長(zhǎng)治路店",

錯(cuò)誤示例3:

{"business":{

   "base_info":{

                   "sid":"33788392",

                 "business_name":"屈臣氏(北京路店)",

                   "branch_name":""

出錯(cuò)原因:包含了括號(hào);分店名寫(xiě)在了門(mén)店名中

正確示例:

{"business":{

   "base_info":{

                   "sid":"33788392",

                 "business_name":"屈臣氏",

                 "branch_name":"北京路店",

錯(cuò)誤示例4:

{"business":{

   "base_info":{

                   "sid":"33788392",

                 "business_name":"黃記煌",

                 "branch_name":"黃記煌成都春熙路店",

出錯(cuò)原因:門(mén)店名和分店名重復(fù)

正確示例:

{"business":{

   "base_info":{

                   "sid":"33788392",

                 "business_name":"黃記煌",

                 "branch_name":"春熙路店",

錯(cuò)誤示例5:

{"business":{

   "base_info":{

                   "sid":"33788392",

                 "business_name":"麗影廣場(chǎng)",

                 "branch_name":"麥當(dāng)勞",

出錯(cuò)原因:理解有誤,將門(mén)店名和分店名填反

正確示例:

{"business":{

   "base_info":{

                   "sid":"33788392",

                 "business_name":"麥當(dāng)勞",

                 "branch_name":"麗影廣場(chǎng)店",

注意:最終門(mén)店名和分店名將以“business_namebranch_name)”的形式拼合顯示,請(qǐng)?jiān)谔顚?xiě)時(shí)考慮展示效果(其中括號(hào)為統(tǒng)一自動(dòng)添加,請(qǐng)不要自行添加);不同字段搜索和存儲(chǔ)規(guī)則不同,請(qǐng)嚴(yán)格按照規(guī)范填寫(xiě)門(mén)店信息,以保證用戶(hù)順利搜索、找到您的門(mén)店;隨后填寫(xiě)的地址信息中將包含區(qū)域信息,一同展示給用戶(hù),不必在名稱(chēng)中重復(fù)填寫(xiě)地區(qū)信息。

2)詳細(xì)地址

準(zhǔn)確填寫(xiě)門(mén)店所在地址和門(mén)牌號(hào),務(wù)必至少包括“XX路XX號(hào)”這一基本信息;因?yàn)闊o(wú)法檢索和定位,請(qǐng)不要只填寫(xiě)“XX樓下”、“XX左側(cè)100米”、“XX商廈首層”、“XX地鐵站D出口向北100米”這類(lèi)的信息,如要保留,請(qǐng)先保證門(mén)牌號(hào)準(zhǔn)確填寫(xiě)。

請(qǐng)不要在“詳細(xì)地址”字段中重復(fù)填寫(xiě)省市區(qū)信息,直轄市除外(province、city均要填寫(xiě))

錯(cuò)誤示例:

                   "province":"浙江省",

                   "city":"杭州市",

                   "district":"下城區(qū)",

                   "address":"杭州市下城區(qū)慶春路86號(hào)世紀(jì)聯(lián)華超市5樓",

出錯(cuò)原因:在詳細(xì)地址中重復(fù)填寫(xiě)了省市區(qū)信息,造成拼合后重復(fù)顯示。錯(cuò)誤展示效果:浙江省杭州市下城區(qū)杭州市下城區(qū)慶春路86號(hào)世紀(jì)聯(lián)華超市5樓。

正確示例:

                   "province":"浙江省",

                   "city":"杭州市",

                   "district":"下城區(qū)",

                   "address":"慶春路86號(hào)世紀(jì)聯(lián)華超市5樓",

正確展示效果:浙江省杭州市下城區(qū)慶春路86號(hào)世紀(jì)聯(lián)華超市5樓。

直轄市信息填寫(xiě)示例:

                   "province":"上海市",

                   "city":"上海市",

                   "district":"徐匯區(qū)",

                   "address":"田林路397號(hào)中環(huán)國(guó)際廣場(chǎng)A樓",

3)類(lèi)目信息

商戶(hù)按照類(lèi)目列表選擇實(shí)際門(mén)店對(duì)應(yīng)的類(lèi)目。

錯(cuò)誤示例:

{"business":{

   "base_info":{

                   "sid":"33788392",

                   "business_name":"麥當(dāng)勞",

                   "branch_name":"藝苑路店",

                   "province":"廣東省",

                   "city":"廣州市",

                   "district":"海珠區(qū)",

                   "address":"藝苑路11 號(hào)",

                   "telephone":"020-12345678",

                   "categories":["美食,茶餐廳"], 

出錯(cuò)原因:將麥當(dāng)勞的類(lèi)目信息寫(xiě)成“美食,茶餐廳”。

4)電話(huà)

填寫(xiě)的電話(huà)信息需要真實(shí)有效,審核過(guò)程會(huì)進(jìn)行電話(huà)抽審,無(wú)人接聽(tīng)或電話(huà)無(wú)效會(huì)影響審核結(jié)果。

只能含有數(shù)字和“-”字符;固定電話(huà)須填寫(xiě)區(qū)號(hào);區(qū)號(hào)、分機(jī)號(hào)均用“-”連接;現(xiàn)階段請(qǐng)不要填寫(xiě)多個(gè)電話(huà)。

錯(cuò)誤示例1:

"telephone":"(010)87632851",

錯(cuò)誤原因:區(qū)號(hào)未用“-”連接。

錯(cuò)誤示例2:

"telephone":"34435764",

錯(cuò)誤原因:固定電話(huà)未加區(qū)號(hào)。

錯(cuò)誤示例3:

"telephone":"13880934557、0351-34435764",

錯(cuò)誤原因:填寫(xiě)了多個(gè)電話(huà)。

錯(cuò)誤示例4:

"telephone":"138-8093-4557",

錯(cuò)誤原因:手機(jī)號(hào)碼內(nèi)部不應(yīng)用“-”間隔。

錯(cuò)誤示例5:

"telephone":"8003800轉(zhuǎn)4010",

錯(cuò)誤原因:分機(jī)號(hào)未用“-”連接。

錯(cuò)誤示例6:

"telephone":"8003800#4010",

錯(cuò)誤原因:分機(jī)號(hào)未用“-”連接

 

正確示例:

"telephone":"021-81445873",
"telephone":"021-81445873-1003",

"telephone":"13867428497",
"telephone":"4008002835",


5)經(jīng)緯度:

可利用以下工具找到各門(mén)店對(duì)應(yīng)的經(jīng)緯度坐標(biāo),導(dǎo)出相應(yīng)坐標(biāo)值。

詳見(jiàn)鏈接:坐標(biāo)拾取器地址。

http://lbs.qq.com/tool/getpoint/index.html  

注意:經(jīng)緯度坐標(biāo)需要轉(zhuǎn)換為騰訊地圖坐標(biāo)。

詳見(jiàn)鏈接:

http://lbs.qq.com/webservice_v1/guide-convert.html

3.3審核事件推送

新創(chuàng)建的門(mén)店在審核通過(guò)后,會(huì)以事件形式推送給商戶(hù)填寫(xiě)的回調(diào)URL(登陸公眾平臺(tái)進(jìn)入“開(kāi)發(fā)者中心”設(shè)置)

微信服務(wù)器在五秒內(nèi)收不到響應(yīng)會(huì)斷掉連接,并且重新發(fā)起請(qǐng)求,總共重試三次。 關(guān)于重試的消息排重,推薦使用FromUserName + CreateTime 排重。

假如服務(wù)器無(wú)法保證在五秒內(nèi)處理并回復(fù),可以直接回復(fù)空串,微信服務(wù)器不會(huì)對(duì)此作任何處理,并且不會(huì)發(fā)起重試。

推送XML數(shù)據(jù)包示例:

<xml>

<ToUserName><![CDATA[toUser]]></ToUserName>

<FromUserName><![CDATA[fromUser]]></FromUserName>

<CreateTime>1408622107</CreateTime>

<MsgType><![CDATA[event]]></MsgType>

<Event><![CDATA[poi_check_notify]]></Event>

<UniqId><![CDATA[123adb]]></UniqId>

<PoiId><![CDATA[123123]]></PoiId>

<Result><![CDATA[fail]]></Result>

<msg><![CDATA[xxxxxx]]></msg>

</xml>

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

字段說(shuō)明
ToUserName發(fā)送方帳號(hào)(一個(gè)OpenID)
FromUserName錯(cuò)誤信息
CreateTime消息創(chuàng)建時(shí)間(整型)
MsgType消息類(lèi)型,event
Event事件類(lèi)型,poi_check_notify
UniqId商戶(hù)自己內(nèi)部ID,即字段中的sid
PoiId微信的門(mén)店ID,微信內(nèi)門(mén)店唯一標(biāo)示ID
Result審核結(jié)果,成功succ 或失敗fail
msg成功的通知信息,或?qū)徍耸〉鸟g回理由

3.4查詢(xún)門(mén)店信息

接口說(shuō)明

創(chuàng)建門(mén)店后獲取poi_id 后,商戶(hù)可以利用poi_id,查詢(xún)具體某條門(mén)店的信息。 若在查詢(xún)時(shí),update_status 字段為1,表明在5 個(gè)工作日內(nèi)曾用update 接口修改過(guò)門(mén)店擴(kuò)展字段,該擴(kuò)展字段為最新的修改字段,尚未經(jīng)過(guò)審核采納,因此不是最終結(jié)果。最終結(jié)果會(huì)在5 個(gè)工作日內(nèi),最終確認(rèn)是否采納,并前端生效(但該擴(kuò)展字段的采納過(guò)程不影響門(mén)店的可用性,即available_state仍為審核通過(guò)狀態(tài)

注:擴(kuò)展字段為公共編輯信息(大家都可修改),修改將會(huì)審核,并決定是否對(duì)修改建議進(jìn)行采納,但不會(huì)影響該門(mén)店的生效可用狀態(tài)。

接口調(diào)用請(qǐng)求說(shuō)明

協(xié)議https
http請(qǐng)求方式POST
請(qǐng)求Urlhttp://api.weixin.qq.com/cgi-bin/poi/getpoi?access_token=TOKEN
POST數(shù)據(jù)格式json

請(qǐng)求參數(shù)說(shuō)明

參數(shù)說(shuō)明是否必填
access_token調(diào)用接口憑證
bufferjson數(shù)據(jù)

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

{

"poi_id":"271262077"

}

返回?cái)?shù)據(jù)說(shuō)明

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

{

    "errcode":0,

    "errmsg":"ok",

    "business ":{

    "base_info":{

                 "sid":"001",

                 "business_name":"麥當(dāng)勞",

                 "branch_name":"藝苑路店",

                 "province":"廣東省",

                 "city":"廣州市",

                 "address":"海珠區(qū)藝苑路11 號(hào)",

                 "telephone":"020-12345678",

                 "categories":["美食,小吃快餐"],

                 "offset_type":1,

                 "longitude":115.32375,

                 "latitude":25.097486,

                 "photo_list":[{"photo_url":"https:// XXX.com"} , {"photo_url":"https://XXX.com"}],

                 "recommend":"麥辣雞腿堡套餐,麥樂(lè)雞,全家桶",

                 "special":"免費(fèi)wifi,外賣(mài)服務(wù)",

                 "introduction":"麥當(dāng)勞是全球大型跨國(guó)連鎖餐廳,1940 年創(chuàng)立于美國(guó),在世界上大

     約擁有3 萬(wàn)間分店。主要售賣(mài)漢堡包,以及薯?xiàng)l、炸雞、汽水、冰品、沙拉、水果等快餐食品",

                 "open_time":"8:00-20:00",

                 "avg_price":35

                 "available_state":3

                 "update_status":0

                }

        }

 }

字段說(shuō)明
errcode錯(cuò)誤碼,0為正常
errmsg錯(cuò)誤信息
available_state門(mén)店是否可用狀態(tài)。1 表示系統(tǒng)錯(cuò)誤、2 表示審核中、3 審核通過(guò)、4 審核駁回。當(dāng)該字段為1、2、4 狀態(tài)時(shí),poi_id 為空
update_status擴(kuò)展字段是否正在更新中。1 表示擴(kuò)展字段正在更新中,尚未生效,不允許再次更新; 0 表示擴(kuò)展字段沒(méi)有在更新中或更新已生效,可以再次更新
business門(mén)店信息,字段內(nèi)容同前

*注其他字段同前

3.5查詢(xún)門(mén)店列表

接口說(shuō)明

商戶(hù)可以通過(guò)該接口,批量查詢(xún)自己名下的門(mén)店list,并獲取已審核通過(guò)的poi_id(所有狀態(tài)均會(huì)返回poi_id,但該poi_id不一定為最終id)、商戶(hù)自身sid 用于對(duì)應(yīng)、商戶(hù)名、分店名、地址字段。

接口調(diào)用請(qǐng)求說(shuō)明

協(xié)議https
http請(qǐng)求方式POST
請(qǐng)求Urlhttps://api.weixin.qq.com/cgi-bin/poi/getpoilist?access_token=TOKEN
POST數(shù)據(jù)格式json

請(qǐng)求參數(shù)說(shuō)明

參數(shù)說(shuō)明是否必填
access_token調(diào)用接口憑證
bufferjson數(shù)據(jù)

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

{

"begin":0,

"limit":10

}

字段說(shuō)明

字段說(shuō)明是否必填
begin開(kāi)始位置,0 即為從第一條開(kāi)始查詢(xún)
limit返回?cái)?shù)據(jù)條數(shù),最大允許50,默認(rèn)為20

返回?cái)?shù)據(jù)說(shuō)明

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

為審核通過(guò),有poi_id,全部字段;第二條為審核不通過(guò),僅有基礎(chǔ)字段;第三條為審核中,僅有基礎(chǔ)字段。

{

 "errcode":0,

 "errmsg":"ok"

 "business_list":[

{"base_info":{

                "sid":"101",

                "business_name":"麥當(dāng)勞",

                "branch_name":"藝苑路店",

                "address":"藝苑路11號(hào)",

                "telephone":"020-12345678",

                "categories":["美食,快餐小吃"],

                "city":"廣州市",

                "province":"廣東省",

                "offset_type":1,

                "longitude":115.32375,

                "latitude":25.097486,

                "photo_list":[{"photo_url":"http: ...."}],

                "introduction":"麥當(dāng)勞是全球大型跨國(guó)連鎖餐廳,1940 年創(chuàng)立于美國(guó),在世界上大約擁有3 萬(wàn)間分店。主要售賣(mài)漢堡包,以及薯?xiàng)l、炸雞、汽水、冰品、沙拉、水果等快餐食品",

                "recommend":"麥辣雞腿堡套餐,麥樂(lè)雞,全家桶",

                "special":"免費(fèi)wifi,外賣(mài)服務(wù)",

                "open_time":"8:00-20:00",

                "avg_price":35,

                "poi_id":"285633617",

                "available_state":3,

                "district":"海珠區(qū)",

                "update_status":0

              }},

{"base_info":{

                "sid":"101",

                "business_name":"麥當(dāng)勞",

                "branch_name":"北京路店",

                "address":"北京路12號(hào)",

                "telephone":"020-12345689",

                "categories":["美食,快餐小吃"],

                "city":"廣州市",

                "province":"廣東省",

                "offset_type":1,

                "longitude":115.3235,

                "latitude":25.092386,

                "photo_list":[{"photo_url":"http: ...."}],

                "introduction":"麥當(dāng)勞是全球大型跨國(guó)連鎖餐廳,1940 年創(chuàng)立于美國(guó),在世界上大約擁有3 萬(wàn)間分店。主要售賣(mài)漢堡包,以及薯?xiàng)l、炸雞、汽水、冰品、沙拉、水果等快餐食品",

                "recommend":"麥辣雞腿堡套餐,麥樂(lè)雞,全家桶",

                "special":"免費(fèi)wifi,外賣(mài)服務(wù)",

                "open_time":"8:00-20:00",

                "avg_price":35,

                "poi_id":"285633618",

                "available_state":4,

                "district":"越秀區(qū)",

                "update_status":0

              }},

 {"base_info":{

                "sid":"101",

                "business_name":"麥當(dāng)勞",

                "branch_name":"龍洞店",

                "address":"迎龍路122號(hào)",

                "telephone":"020-12345659",

                "categories":["美食,快餐小吃"],

                "city":"廣州市",

                "province":"廣東省",

                "offset_type":1,

                "longitude":115.32345,

                "latitude":25.056686,

                "photo_list":[{"photo_url":"http: ...."}],

                "introduction":"麥當(dāng)勞是全球大型跨國(guó)連鎖餐廳,1940 年創(chuàng)立于美國(guó),在世界上大約擁有3 萬(wàn)間分店。主要售賣(mài)漢堡包,以及薯?xiàng)l、炸雞、汽水、冰品、沙拉、水果等快餐食品",

                "recommend":"麥辣雞腿堡套餐,麥樂(lè)雞,全家桶",

                "special":"免費(fèi)wifi,外賣(mài)服務(wù)",

                "open_time":"8:00-20:00",

                "avg_price":35,

                "poi_id":"285633619",

                "available_state":2,

                "district":"天河區(qū)",

                "update_status":0

              }},

],

       "total_count":"3",

}

參數(shù)說(shuō)明
access_token調(diào)用接口憑證
bufferjson數(shù)據(jù)
total_count門(mén)店總數(shù)量

3.6修改門(mén)店服務(wù)信息

接口說(shuō)明

商戶(hù)可以通過(guò)該接口,修改門(mén)店的服務(wù)信息,包括:sid、圖片列表、營(yíng)業(yè)時(shí)間、推薦、特色服務(wù)、簡(jiǎn)介、人均價(jià)格、電話(huà)8個(gè)字段(名稱(chēng)、坐標(biāo)、地址等不可修改)修改后需要人工審核。

接口調(diào)用請(qǐng)求說(shuō)明

協(xié)議https
http請(qǐng)求方式POST/FROM
請(qǐng)求Urlhttps://api.weixin.qq.com/cgi-bin/poi/updatepoi?access_token=TOKEN
POST數(shù)據(jù)格式buffer

請(qǐng)求參數(shù)說(shuō)明

參數(shù)說(shuō)明是否必填
access_token調(diào)用接口憑證
bufferjson數(shù)據(jù)

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

{"business ":{

   "base_info":{

                  "poi_id ":"271864249"

                  "sid":"A00001"

                  "telephone ":"020-12345678"

                  "photo_list":[{"photo_url":"https:// XXX.com"},{"photo_url":"https://XXX.com"}],

                  "recommend":"麥辣雞腿堡套餐,麥樂(lè)雞,全家桶",

                  "special":"免費(fèi)wifi,外賣(mài)服務(wù)",

                  "introduction":"麥當(dāng)勞是全球大型跨國(guó)連鎖餐廳,1940 年創(chuàng)立于美國(guó),在世界上大約擁有3 萬(wàn)間分店。主要售賣(mài)漢堡包,以及薯?xiàng)l、炸雞、汽水、冰品、沙拉、水果等快餐食品",

                  "open_time":"8:00-20:00",

                  "avg_price":35

              }

      }

}

字段說(shuō)明:

全部字段內(nèi)容同前。

特別注意:

以上8個(gè)字段,若有填寫(xiě)內(nèi)容則為覆蓋更新,若無(wú)內(nèi)容則視為不修改,維持原有內(nèi)容。 photo_list 字段為全列表覆蓋,若需要增加圖片,需將之前圖片同樣放入list 中,在其后增加新增圖片。如:已有A、B、C 三張圖片,又要增加D、E 兩張圖,則需要調(diào)用該接口,photo_list 傳入A、B、C、D、E 五張圖片的鏈接。

返回?cái)?shù)據(jù)說(shuō)明

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

{

"errcode":0,

"errmsg":"ok"

}

字段說(shuō)明
errcode錯(cuò)誤碼,0為正常
errmsg錯(cuò)誤信息

3.7刪除門(mén)店

接口說(shuō)明

商戶(hù)可以通過(guò)該接口,刪除已經(jīng)成功創(chuàng)建的門(mén)店。請(qǐng)商戶(hù)慎重調(diào)用該接口。

接口調(diào)用請(qǐng)求說(shuō)明

協(xié)議https
http請(qǐng)求方式POST/FROM
請(qǐng)求Urlhttps://api.weixin.qq.com/cgi-bin/poi/delpoi?access_token=TOKEN
POST數(shù)據(jù)格式buffer

請(qǐng)求參數(shù)說(shuō)明

參數(shù)說(shuō)明
access_token調(diào)用接口憑證
POSTjson數(shù)據(jù)

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

{

"poi_id": "271262077"

}

字段說(shuō)明:

字段說(shuō)明
poi_id門(mén)店ID

返回?cái)?shù)據(jù)說(shuō)明

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

{

"errcode":0,

"errmsg":"ok"

}

字段說(shuō)明
errcode錯(cuò)誤碼,0為正常
errmsg錯(cuò)誤信息

4.門(mén)店類(lèi)目表

接口說(shuō)明

類(lèi)目名稱(chēng)接口是為商戶(hù)提供自己門(mén)店類(lèi)型信息的接口。門(mén)店類(lèi)目定位的越規(guī)范,能夠精準(zhǔn)的吸引更多用戶(hù),提高曝光率。

接口調(diào)用的請(qǐng)求說(shuō)明

協(xié)議https
http請(qǐng)求方式GET
請(qǐng)求Url

http://api.weixin.qq.com/cgi-bin/poi/getwxcategory?access_token=TOKEN

返回?cái)?shù)據(jù)說(shuō)明

{

  "category_list":

            ["美食,江浙菜,上海菜","美食,江浙菜,淮揚(yáng)菜","美食,江浙菜,浙江菜","美食,江浙菜,南京菜 ","美食,江浙菜,蘇幫菜…"]

}

5.常見(jiàn)錯(cuò)誤碼

錯(cuò)誤碼errmsg說(shuō)明
-1system error系統(tǒng)錯(cuò)誤,請(qǐng)稍后重試
40009Invalid image size圖片大小為0或者超過(guò)1M
40097invalid args參數(shù)不正確,請(qǐng)參考字段要求檢查json 字段
65104invalid category門(mén)店的類(lèi)型不合法,必須嚴(yán)格按照附表的分類(lèi)填寫(xiě)
65105invalid photo url圖片url 不合法,必須使用接口1 的圖片上傳接口所獲取的url
65106poi audit state must be approved門(mén)店?duì)顟B(tài)必須未審核通過(guò)
65107not allow modify擴(kuò)展字段為不允許修改的狀態(tài)
65109invalid business門(mén)店名為空
65110invalid address門(mén)店所在詳細(xì)街道地址為空
65111invalid telephone門(mén)店的電話(huà)為空
65112invalid city門(mén)店所在的城市為空
65113invalid province門(mén)店所在的省份為空
65114empty photo list圖片列表為空
65115invalid poi idpoi_id 不正確

更多錯(cuò)誤碼請(qǐng)參考“基礎(chǔ)支持-全局返回碼說(shuō)明”

7.聯(lián)系我們

遇到問(wèn)題,可以加入開(kāi)發(fā)者交流群 463320265聯(lián)系我們,驗(yàn)證請(qǐng)說(shuō)明所屬商家和業(yè)務(wù)。