easywechat

Table of Contents

获取实例
创建门店
获取指定门店信息
获取门店列表
修改门店信息
删除门店
错误码

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

获取实例

<?php

use Overtrue\Wechat\Store;

$appId  = 'wx3cf0f39249eb0e60';
$secret = 'f1c242f4f28f735d4687abb469072a29';

$store = new Store($appId, $secret);

创建门店

用 POI 接口新建门店时所使用的图片 url 必须为微信自己域名的 url,因此需要先用上传图片接口上传图片并获取 url,再创建门店。上传的图片限制文件大小限制 1MB,支持 JPG 格式，图片接口请参考：TODO

$store->create($baseInfo);

$baseInfo 为门店的基本信息数组

example:

<?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,
    );

$res = $store->create($info); // true or exception

注意：新创建的门店在审核通过后,会以事件形式推送给商户填写的回调URL

获取指定门店信息

$store->get($storeId);

$storeId 为门店ID

example:

$info = $store->get(271262077);
var_dump($info->business_name); // 麦当劳
var_dump($info->introduction); // 麦当劳是全球大型跨国连锁餐厅...
var_dump($info->toArray());// array('business_name' => '麦当劳', 'branch_name' => '艺苑路店', ...);

获取门店列表

$store->lists($begin = 0, $limit = 10);// begin:0, limit:10

$begin 就是查询起点，MySQL 里的 offset；
$limit 查询条数，同 MySQL 里的 limit；

example:

$stores = $store->lists(0, 2);// 取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 个字段。目前基础字段包括(名称、坐标、地址等不可修改)。

$store->update($storeId, $data);

$storeId 为门店ID
$data 需要更新的部分数据，若有填写内容则为覆盖更新,若无内容则视为不修改,维持原有内容。photo_list 字段为全列表覆盖,若需要增加图片,需将之前图片同样放入 list 中,在其后增加新增图片。如:已有 A、B、C 三张图片,又要增加 D、E 两张图,则需要调用该接口,photo_list 传入 A、B、C、D、E 五张图片的链接。

example:

$data = array(
         "telephone" => "020-12345678",
         "recommend" => "麦辣鸡腿堡套餐,麦乐鸡,全家桶",
         //...
        );

$res = $store->update(271262077, $data); //true or exception

删除门店

$store->delete($storeId);

example:

$store->delete(271262077);// true or exception

错误码

invalid categories 分类不合法,必须严格按照附表的分类填写
invalid photo url 图片 url 不合法,必须使用接口 1 的图片上传接口所获取的 url
poi audit state must be approved 门店状态必须未审核通过
invalid poiid poi_id 不正确
invalid args 参数不正确,请检查 json 字段
system error 系统错误,请稍后重试

中文版 English

中写在前面
EN 升级日志
EN 路线图
基本使用
功能与服务
- EN 用户与用户组管理
- EN 客服管理与发送消息
- EN 多客服的消息转发
- EN 网页授权
- EN 模板消息
- EN 自定义菜单
- EN 素材管理
- EN 卡券
- EN 门店
- EN JSSDK
- EN 二维码
- EN 短链接
- EN 微信支付
- EN 微信红包
- EN 语义理解服务
- EN 数据统计查询服务
其它
- EN 错误处理
- EN 自定义缓存

获取实例

创建门店

获取指定门店信息

获取门店列表

修改门店信息

删除门店

错误码

中文版 English

目录

English 中文版

Table of Contents