?? Meituan-Pub-Union

Meituan-Pub-Union 是美團(tuán)分銷聯(lián)盟API的PHP-SDK

安裝

$ composer require gaowei-space/meituan-pub-union -vvv

配置

在使用本擴(kuò)展之前，你需要去 美團(tuán)分銷聯(lián)盟 注冊賬號(hào)，簽約入駐后創(chuàng)建應(yīng)用，獲取應(yīng)用的 app_key 和 utm_source。

支持

• ? 獲取全國省份 ProvinceAllRequest
• ? 獲取某省份的城市 CitiesRequest
• ? 獲取某個(gè)城市的一級類目包含的二級類目信息 CategoriesRequest
• ? 獲取某個(gè)城市的商圈信息（點(diǎn)評）RegionsByDianPingRequest
• ? 獲取某個(gè)城市的商圈信息（美團(tuán)）RegionsByMeiTuanRequest
• ? 到店商品搜索 SearchDealsRequest (美團(tuán)已停止該接口請求權(quán)限，了解)
• ? 分銷取鏈 LinksRequest
• ? 異常訂單數(shù)據(jù) OrdersAbnormalRequest
• ? CPA訂單數(shù)據(jù) OrdersCPARequest
• ? CPS訂單數(shù)據(jù) OrdersCPSRequest
• ? 秒殺場次 SeckillShowInfoRequest
• ? 秒殺團(tuán)單列表 SeckillListRequest
• ?? 其他暫未支持，接下來會(huì)支持完善到店模塊接口

使用

獲取某個(gè)省份的城市列表

use GaoweiSpace\MeituanPubUnion\Api\Common\Request\CitiesRequest;
use GaoweiSpace\MeituanPubUnion\Http\Client;

$app_key    = 'xxxxxxxxxx';
$utm_source = 'xxxxxxxxxx';

// 實(shí)例化獲取城市的請求類
$request = new CitiesRequest();
// 設(shè)置省份ID
$request->setProvinceId(1);

// 實(shí)例客戶端類
$client = new Client($app_key, $utm_source);

// 發(fā)送請求調(diào)用接口
$response = $client->syncInvoke($request);

請求參數(shù)

請求參數(shù)的設(shè)置，請結(jié)合 美團(tuán)分銷聯(lián)盟API文檔，確認(rèn)要使用的參數(shù)，調(diào)用對應(yīng)請求API類的對應(yīng)方法進(jìn)行設(shè)置

每個(gè)請求API類中對于各個(gè)參數(shù)都已經(jīng)內(nèi)置了 set 前綴的設(shè)置方法，如：

public function setUtmSource(string $utmSource): void
{
    $this->utmSource = $utmSource;
}

調(diào)用對應(yīng)方法，進(jìn)行參數(shù)設(shè)置：

$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 實(shí)例：

方法參數(shù)注入

use GaoweiSpace\MeituanPubUnion\Http\Client;

public function getCities(Client $client)
{
    $response = $client->syncInvoke($request);
}

服務(wù)名訪問

public function getCities()
{
    $response = app('MeituanPubUnion')->syncInvoke($request);
}

參考

• 美團(tuán)分銷聯(lián)盟API文檔

License

MIT