饿了么开放平台接入(1)——开放平台注册与使用

背景

最近有个项目要接入饿了么外卖平台,本来以为很简单的事,结果是这个事还真费了2天功夫,是所谓简单又复杂。

简单方面,因为饿了么封装了sdk,基本相关的业务逻辑都封装好了,比如什么获取订单、取消订单、添加商品,只需要轻松的调用以封装好的sdk中的api(就是调个饿了么封装好的函数),就OK,简直是轻松又愉快。

但是也有复杂的地方,比如涉及开放平台注册账户、账户的种类与区别、如何使用测试用的沙箱环境、如何建立开发者与商户之间的关联、还有如何授权、如何回调、如何获取Token(要调用sdk,就得通过token,token可以认为是你能调用商户兵权的虎符,此处饿了么就是皇帝,因为饿了么拥有所有的数据最高权限,想给你就给你,不想给你就不给你)。

这等等问题,都不难,但是挺烦人,所以本着助人为乐的优良品质、良好态度、高风亮节、高尚品德,就写个博客简单描述下具体的过程。

注册账户

首先登录饿了么开放平台,注册一个账户,地址:饿了么开放平台

这里写图片描述

点击右上角注册就行了,这一步没啥说法,就跟注册个QQ一样简单。

资质认证

注册之后,还不能说你就能开发,作为一个开放平台,总得审审注册用户是不是好人,是不是真的有开发的需求。起码得有个营业执照吧,就算是个小餐厅,那也得有证,否则是非法经营了。

好的,资质认证很简单,点击【个人中心】-【申请认证】,然后按要求填写信息,上传照片即可。

提交了信息之后,就等着审核就行了,一般等个1-3天就能通过,通不过的,嘿嘿,是不是你小子有问题啊,反正我是很快就通过了。

这里写代码片

创建应用

1、应用的概念

啥是应用,所谓的应用就是一个模块。比如你是一个程序员,要给三家包子铺开发外卖程序,那就可以建三个应用对应这三家店,当然实际上也可以建一个应用对应三家店。也就是说,应用就是一个程序员视角的功能模块,反正不管怎么着至少得建一个。

需要注意的是,资质认证没通过的时候,也可以创建应用哦。

具体创建方法也很简单,点击【管理中心】-【新建应用】即可,如下图:
这里写图片描述

2、应用种类

新建应用时,会提示创建应用的种类,分为平台应用、企业应用、线下服务三类,如图:

这里写代码片

简单的说,平台应用是面向大客户的(要求服务1万家以上商户),这个估计有点难,反正我们公司暂时达不到。

企业应用,就是面向普通公司的,我们就选这个。

线下服务,无需代码开发,这个跟我们程序员关系不大,果断抛弃。

3、应用的具体信息

选择应用的种类之后,就是填写具体信息了,需要注意下应用权限那边根据自己的需求选就行了,不确定的话可以都选上。

还有图片必须是正方形,这个自己用画图软件改改就行,画图软件的我就不具体介绍怎么使用了,虽然我用画图那是很厉害的。
这里写图片描述

应用的测试环境(沙箱环境)与正式环境

1、沙箱环境概念

所谓正式环境,就是真的有一家或多家饿了么的店铺可以对接到的环境,操作的数据都是真实的饿了么平台的数据。

所谓测试环境,就是一些仅仅作为开发时测试的数据,这部分数据是没有真实作用的,所以哈哈,测试环境下的单是没有外卖骑手去送餐的。

饿了么的测试环境也叫沙箱环境,沙箱这个词很多平台都在用,非常形象。就是说测试环境都是装在一个箱子里的,外面的人也不知里面装的什么,怎么处理,跟外界正式环境是隔离的。但是沙箱和正式环境操作规则是一样的,就是写的代码一样用。

2、查看正式环境与沙箱环境

点击【管理中心】-【查看应用】-【正式环境】,可以看到正式环境的信息,此处因为资质认证没通过,所以暂时看不到。

点击【管理中心】-【沙箱环境】,可以看到沙箱环境的信息如图:
这里写图片描述

3、沙箱环境参数解释

从上图可以看到很多参数,这些参数正式环境也有,但是跟沙箱环境数值是不一样的。饿了么开放平台看到咱们的程序传的参数是沙箱环境的参数,就知道这些数据应该是沙箱环境的测试数据,就把这部分数据跟正式环境隔离开了。

所以在做测试的时候,沙箱环境都单独的测试店铺URL,通过这个URL登录店铺操作的数据就是沙箱数据了。

其他参数如Key、Secret等待下篇讲解代码部分是具体介绍。

下一步工作

至此咱们有了沙箱环境,正式环境也提出资质申请了,可以先行在沙箱环境进行开发测试,待资质申请通过后把测试通过的程序往正式环境切换就OK了。