🌈 Meituan-Pub-Union
Meituan-Pub-Union 是美团分销联盟API的PHP-SDK
安装
$ composer require gaowei-space/meituan-pub-union -vvv
配置
在使用本扩展之前，你需要去 美团分销联盟 注册账号，签约入驻后创建应用，获取应用的 app_key 和 utm_source。
支持
- ✅ 获取全国省份
ProvinceAllRequest - ✅ 获取某省份的城市
CitiesRequest - ✅ 获取某个城市的一级类目包含的二级类目信息
CategoriesRequest - ✅ 获取某个城市的商圈信息（点评）
RegionsByDianPingRequest - ✅ 获取某个城市的商圈信息（美团）
RegionsByMeiTuanRequest - ✅ 到店商品搜索
SearchDealsRequest(美团已停止该接口请求权限，了解) - ✅ 分销取链
LinksRequest - ✅ 异常订单数据
OrdersAbnormalRequest - ✅ CPA订单数据
OrdersCPARequest - ✅ CPS订单数据
OrdersCPSRequest - ✅ 秒杀场次
SeckillShowInfoRequest - ✅ 秒杀团单列表
SeckillListRequest - 🆕 其他暂未支持，接下来会支持完善到店模块接口
使用
获取某个省份的城市列表
use GaoweiSpace\MeituanPubUnion\Api\Common\Request\CitiesRequest;
use GaoweiSpace\MeituanPubUnion\Http\Client;
$app_key = 'xxxxxxxxxx';
$utm_source = 'xxxxxxxxxx';
// 实例化获取城市的请求类
$request = new CitiesRequest();
// 设置省份ID
$request->setProvinceId(1);
// 实例客户端类
$client = new Client($app_key, $utm_source);
// 发送请求调用接口
$response = $client->syncInvoke($request);
请求参数
请求参数的设置，请结合 美团分销联盟API文档，确认要使用的参数，调用对应请求API类的对应方法进行设置
每个请求API类中对于各个参数都已经内置了 set 前缀的设置方法，如：
public function setUtmSource(string $utmSource): void
{
$this->utmSource = $utmSource;
}
调用对应方法，进行参数设置：
$request->setUtmSource('***');
在 Laravel 中使用
在 Laravel 中使用也是同样的安装方式，配置写在 config/services.php 中：
'meituan' => [
'pub_union' => [
'app_key' => env('MEITUAN_PUB_UNION_APP_KEY'),
'utm_source' => env('MEITUAN_PUB_UNION_UTM_SOURCE'),
]
]
然后在 .env 中配置：
MEITUAN_PUB_UNION_APP_KEY=xxxxxxxxxxxxxxxxxxxxx
MEITUAN_PUB_UNION_UTM_SOURCE=xxxxxxxxxxxxxxxxxxxxx
可以用两种方式来获取 GaoweiSpace\MeituanPubUnion\Http\Client 实例：
方法参数注入
use GaoweiSpace\MeituanPubUnion\Http\Client;
public function getCities(Client $client)
{
$response = $client->syncInvoke($request);
}
服务名访问
public function getCities()
{
$response = app('MeituanPubUnion')->syncInvoke($request);
}
参考
License
MIT
