一. 入门坑深似海. 看下美团外卖的文档, 简单粗暴 有底气~
但是里面只有JAVA的SDK~ 木有PHP的..(((((
下面就说说, 如何用接通美团外卖 (外卖模块)
美团外卖文档 : http://developer.meituan.com/openapi
正常 美团外卖下单流程
客户端下单 -> 推送到商家后台 -> 接单 -> 送餐 -> 完成
二. 你要具备测试的工具还有APP
一台手机. ~美团外卖APP美团外卖商家版APP(你的APP)
问题1: 如何找到我的测试店铺?在开发者中心下, 会提供一个测试门店给你. 当然也可以自己新增 (建议用永久的)
image.png
四: 开发 (按着顺序来)
1: 门店授权 http://developer.meituan.com/openapi#4.1.2
商家授权步骤: 点击进入 -> 授权登录页面 -> 选择门店 -> 绑定成功
开发步骤:
组装 请求URL -> 跳转到 -> 回调接口
1:组装 URL
image.png
解析:
1: 上面的developerId和signKey 都可以在开发者中心里面获取到.
2: ePoiId 由你来提供一个ID传输过去, 到时他会带回这个ID回调给你, (这里推荐使用数据库自增ID,不然的话你会挖坑的)
3: businessId 如上, 自己选择就行, (外卖选2)
2:跳转到URL
image.png
3: 回调接口
先看回调参数
image.png
上面是客户在登录完授权成功之后, 美团会带数据回调你预先调好的地址, 如下
image.png
参数解析,
appAuthToken 是token , 用于以后每次的操作时候要带的签名组装使用.
timestamp 过期时间戳, 基本不用理, 15年以上 都是永久的.
回调接口的开发:
要先注意的是.
1: 开发者收到token信息，必须返回json字符串{“data”:”success”}
如果平台没收到的话,会隔一段时间再访问你的回调接口, 10次之后, 他就会报警发信息到你手机上了.~ 如下图.
image.png
一般我会把这条JSON放在代码的头部, 然后下面再开始我的逻辑.
2:开放平台回传token信息的方式是post，contentType是application/x-www-form-urlencoded，不是json
image.png
所以你直接在上面post就能得到了. 如上图.
3: 然后你可以开始下面你自己的逻辑了. 把信息入库什么的.. 这个就要看你们公司的业务是怎么样的了.~
2: 订单回调接口 http://developer.meituan.com/openapi#7.5.1
商家步骤 : 买家下单 -> 商家收到新订单通知
开发业务逻辑 : 收到新订单通知 -> 回调接口 -> 处理
回调接口依然要从回调地址上面写好要回调的地址
开始写代码了. 要注意了. 这次回调的JSON就跟授权回调的json不同了..
image.png
但接受信息依然是用POST来接收
image.png
订单的推送接口. 你看下上面的逻辑, 然后再来处理就OK了.
注意返回的order是一条json数据~
image.png
image.png
这个很简单~~
3: 订单操作
商家在上面使用操作步骤, 比如 查看订单, 同意接单等操作.
image.png
拿一个做示例~ 同意接单操作
1: 组装数据
使用post 与 地址
image.png
再看下请求示例
image.png
其他数据都有了. 有个sign签名是要自己去生成的,
sign签名 http://developer.meituan.com/openapi#3.1
授权加密流程
传递参数 -> 组装参数 -> 得到 sign = ( sha1( 按照key排序 + signKey ) -> 组装URL = ( $url + ? + $urlStr + sign ) -> 调用
image.png
可以参照一下我的. 如上图
然后就可以curl post过去. 如果成功, 会返回一个
image.png
玩懂了以上操作, 其他也就懂了~~
总结要注意的地方:
1: 回调JSON返回, 授权与其他回调要返回的json是不同的
2: 回调接口链接填写
如果你的链接是 带有’ | ‘ 的. 如果直接丢上去的话, 是会被报错无法调用成功的,. 所以, 我们要使用下转义
把 | 转为&7C
image.png
3: 调用接口注意,
请熟读他的sign. 虽然说是简单粗暴~
任何一条参数,
都不能是空的.
都不能是空的,
都不能是空的
重要的事情说三遍, 不然你就乖乖的等着被报签名错误吧~
测试总结: ( 持续更新)
问题1: 在美团APP如何找到你的测试门店?
下单测试步骤,
美团外卖APP -> 定位到 墨脱县 色金拉 -> 输入测试门店名称
持续更新, 有不懂的可以私聊问问哈, 我会继续贴上~ 还有核心优化的问题,也可以问下
