門店
創建門店
用 POI
接口新建門店時所使用的圖片 url
必須為微信自己域名的 url
,因此需要先用上傳圖片接 口上傳圖片并獲取 url
,再創建門店。上傳的圖片限制文件大小限制 1MB
,支持 JPG
格式,圖片接口請參考:臨時素材
$officialAccount->poi->create($baseInfo);
array $baseInfo
。為門店的基本信息數組
使用示例:
<?php
$info = array(
"sid" => "33788392",
"business_name" => "麥當勞",
"branch_name" => "藝苑路店",
"province" => "廣東省",
"city" => "廣州市",
"district" => "海珠區",
"address" => "藝苑路 11 號",
"telephone" => "020-12345678",
"categories" => array("美食,快餐小吃"),
"offset_type" => 1,
"longitude" => 115.32375,
"latitude" => 25.097486,
"photo_list" => array(
array("photo_url" => "https://XXX.com"),
array("photo_url" => "https://XXX.com"),
),
"recommend" => "麥辣雞腿堡套餐,麥樂雞,全家桶",
"special" => "免費 wifi,外賣服務",
"introduction" => "麥當勞是全球大型跨國連鎖餐廳,1940 年創立于美國,在世界上大約擁有 3 萬間分店。主要售賣漢堡包,以及薯條、炸雞、汽水、冰品、沙拉、水果等 快餐食品",
"open_time" => "8:00-20:00",
"avg_price" => 35,
);
$result = $officialAccount->poi->create($info); // true or exception
注意:新創建的門店在審核通過后,會以事件形式推送給商戶填寫的回調
URL
獲取指定門店信息
$officialAccount->poi->get($poiId);
int $poiId
。為門店ID
使用示例:
<?php
$info = $officialAccount->poi->get(271262077);
獲取門店列表
// begin: 0, limit: 10
$officialAccount->poi->list($begin, $limit);
int $begin
就是查詢起點,MySQL
里的offset
;int $limit
查詢條數,同MySQL
里的limit
;
兩參數均可選。
使用示例:
<?php
// 取 2 條記錄
$pois = $officialAccount->poi->list(0, 2);
// 獲取結果:
/*
[
{
"sid": "100",
"poi_id": "271864249",
"business_name": "麥當勞",
"branch_name": "藝苑路店",
"address": "藝苑路 11 號",
"available_state": 3
},
{
"sid": "101",
"business_name": "麥當勞",
"branch_name": "赤崗路店",
"address": "赤崗路 102 號",
"available_state": 4
}
]
*/
修改門店信息
商戶可以通過該接口,修改門店的服務信息,包括:圖片列表、營業時間、推薦、特色服務、簡 介、人均價格、電話 7 個字段。目前基礎字段包括(名稱、坐標、地址等不可修改)。
$officialAccount->poi->update($poiId, $baseInfo);
int $poiId
。為門店ID
array $baseInfo
。需要更新的部分數據,若有填寫內容則為覆蓋更新,若無內容則視為不 修改,維持原有內容。photo_list
字段為全列表覆蓋,若需要增加圖片,需將之前圖片同樣放入list
中,在其后增加新增圖片。如:已有A、B、C
三張圖片,又要增加D、E
兩張圖,則需要調用該接口,在photo_list
中傳入A、B、C、D、E
五張圖片的鏈接。
使用示例:
<?php
$data = array(
"telephone" => "020-12345678",
"recommend" => "麥辣雞腿堡套餐,麥樂雞,全家桶",
// ...
);
// true or exception
$res = $officialAccount->poi->update(271262077, $data);
刪除門店
$officialAccount->poi->delete($poiId);
使用示例:
// true or exception
$officialAccount->poi->delete(271262077);