美團分銷聯盟介面SDK(支援美團外賣CPA/CPS訂單拉取和活動取鏈)

willgao發表於2021-11-27

? 美團分銷聯盟 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);
}

參考

License

MIT

本作品採用《CC 協議》,轉載必須註明作者和本文連結
Challenge Limits

相關文章