美团分销联盟接口SDK（支持美团外卖CPA/CPS订单拉取和活动取链）

🌈 美团分销联盟 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
• 🆕 其他暂未支持，接下来会支持完善到店模块接口

使用

获取某个省份的城市列表

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);
}

参考

• 美团分销联盟API文档

License

MIT

本作品采用《CC 协议》，转载必须注明作者和本文链接