finecho/meituan

美团开放平台 SDK

温馨提示

目前仅支持美团外卖服务

安装

环境要求：

composer require finecho/meituan -vvv

配置

$config = [ // 必填，app_id、secret_id 'app_id' => 10020201024, 'secret_id' => 'AKIDsiQzQla780mQxLLU2GJCxxxxxxxxxxx', // 是否开启表单验证 'form_verify' => false, ];

使用

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

方式一 - 封装方式调用

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

方式二 - 原始方式调用

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

方式三 - 链式调用

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

use EasyMeiTuanApplication; $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 规则。

// 默认需要解码字段以及规则 EasyMeiTuanServer::$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 都会注释上美团文档地址，查询困难时，可以直接搜索匹配。