finecho/meituan

美团开放平台 SDK

温馨提示

⚠️ 目前仅支持美团外卖服务

安装

环境要求：

PHP >= 8.0

composer require finecho/meituan -vvv

配置

$config = [
    // 必填，app_id、secret_id
    'app_id' => 10020201024, 
    'secret_id' => 'AKIDsiQzQla780mQxLLU2GJCxxxxxxxxxxx', 

    // 是否开启表单验证
    'form_verify' => false,
];

使用

您可以使用三种调用方式：封装方式调用、原始方式调用和链式调用，请根据你的喜好自行选择使用方式，效果一致。

方式一 - 封装方式调用

use EasyMeiTuan\Application;

$app = new Application($config);

$response = $app->store->create(
    [
        'name'    => 'finecho 的快餐店',
        'address' => '深圳市南山区',
    ]
);

// 也可以这样
$response = $app->store->create(
    [
        'body' => [
            'name'    => 'finecho 的快餐店',
            'address' => '深圳市南山区',
        ],
        'headers' => [],
    ]
);

方式二 - 原始方式调用

use EasyMeiTuan\Application;

$app = new Application($config);

$api = $app->getClient();

$response = $api->post(
    '/poi/save',
    [
        'name'    => 'finecho 的快餐店',
        'address' => '深圳市南山区',
    ]
);

方式三 - 链式调用

你可以将需要调用的 API 以 / 分割 + 驼峰写法的形式，写成如下模式：

use EasyMeiTuan\Application;

$app = new Application($config);

$api = $app->getClient();

$response = $api->poi->save->post(
    [
        'name'    => 'finecho 的快餐店',
        'address' => '深圳市南山区',
    ]
);

表单校验

如果开启表单校验，如果参数缺失或者异常，则会抛出 InvalidParamsException 异常

美团推送

在接收美团推送的时候，Server 会对签名进行校验，并返回解码后的内容

$server = $app->getServer();

// url：在美团外卖设置的回调地址
// content：美团外卖推送过来的内容, 在美团外卖开放平台配置回调地址美团服务器发起验证码时 content 为空数组
$server->withUrl($url)->with(
    function ($content) {
        // ...
    }
);

return $server->serve();

签名校验的时候, 需要将已编码的字段内容进行解码，SDK 提供属性可自行配置 decode 规则。

url：对值进行 urldecode

json：为对值进行 json_decode(val, true)

// 默认需要解码字段以及规则
\EasyMeiTuan\Server::$casts = [
'caution' => 'url',
'detail' => 'url|json',
'extras' => 'url|json',
'recipient_name' => 'url',
'wm_poi_address' => 'url',
'recipient_address' => 'url',
'incmp_modules' => 'url|json',
'order_tag_list' => 'url|json',
'backup_recipient_phone' => 'url|json',
'recipient_address_desensitization' => 'url',

// FBI Warning: nested content needs to pay attention to the order!
'poi_receive_detail_yuan' => 'url|json',
'poi_receive_detail_yuan.reconciliationExtras' => 'json',
'poi_receive_detail' => 'url|json',
'poi_receive_detail.reconciliationExtras' => 'json',
];

API

API 接口众多，每一个 API 都会注释上美团文档地址，查询困难时，可以直接搜索匹配。

:globe_with_meridians: 门店

美团门店文档

具体方法：src/Services/Store.php

$app->store->$method();

:truck: 配送范围

美团配送文档

具体方法：src/Services/DeliveryRange.php

$app->deliveryRange->$method();

:memo: 类目

美团类目文档

具体方法：src/Services/Category.php

$app->category->$method();

:beers: 菜品

美团菜品文档

具体方法：src/Services/Product.php

$app->product->$method();

:page_facing_up: 订单

美团订单文档

具体方法：src/Services/Order.php

$app->order->$method();

:wastebasket: 订单退款

具体方法：src/Services/Refund.php

$app->refund->$method();

:truck: 订单配送

具体方法：src/Services/Logistic.php

$app->logistic->$method();

:package: 众包

具体方法：src/Services/CrowdSourcing.php

$app->crowdSourcing->$method();

:wrench: 全局公共