meituan pub union

? 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

可以用兩種方式來獲取GaoweiSpaceMeituanPubUnionHttpClient實例：

方法參數注入

 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