首页支持中心文档中心
帮助文档
接入指南
菠萝派商城
物流平台
电商平台
淘宝蘑菇街微众金鹰购华为商城魔筷星选微一案新零售中粮我买网顺丰大当家快手小店途虎养车脉宝云店EzBuySEE小电铺辣妈计划友好速搭候鸟联华鲸选京东泰国顺联动力微一案执御微盟微商城云集品华润通国美集团B2B蘑菇街小店一号店Shopee招商银行网上商城江南银行唯品会MP放心购壹钱包立白积分商城萌推蚂蚁销客新蛋商城贝贝网考拉供应商直发海拍客爱奇艺爱库存蜜店宝鲁班天猫超市有赞分销小黑鱼苏宁易购京东全球售五星电器每日一淘格格家履约丰巢好衣库贝壳优品名融秀购商城采多多米多商城飞牛网孩子王一件代发迷橙商城云集POP微盟智慧零售一条电商魅力惠天猫周期送棒棒糖越洋电铺萌店Joom电商绿米新零售零购有量洋葱京东开普勒京东供销美团外卖顺丰优选美丽说有赞零售腾讯枫叶聚宝赞趣头条人人店微商舞象微店自如优品Tokopedia京东印尼微盟阿里巴巴国际站阿里大药房国美IntraMirror孔夫子旧书网豆果美食云尚互联蜜芽东南亚CdiscountJuTa菠萝派商城电商京东考拉速卖通好乐买秀品特奢汇好药师百度Mall聚美海淘优物库人人店折800优购邮乐网下厨房美囤妈妈千米拍鞋网卷皮网辣妈汇敦煌网91拼团宝贝购蜜芽明星衣橱微商户融易购微旺铺Ebay拼多多亲宝宝天虹商场聚美优品ShopEx楚楚街拼团诚信通凡客易订货孩子王达令网小红书善融格格家楚楚街亚马逊当当网平安好医生分期乐好食期HiGo返利网Wish小米商城云集微店麦考林大V店寺库楚楚通TST有赞雅虎LaZaDa苏宁自营订货宝美团梦芭莎穿衣助手唯品会JIT苏宁特卖洋码头垂直采楚楚街预售集盒酒仙唯品会库巴授权米家有品京东自营商派国美自营Wacom亚马逊自营网易严选Eyee京东到家
支付平台
仓储平台
海关平台
外卖平台
其他接口
发票平台
外卖平台接入指南-饿了么

【平台介绍】


饿了么商家开放平台作为一个服务集成平台,致力于满足商户的多样经营性需求,提供合作伙伴更多的平台资源,服务商户接入,提供给商户丰富的经营能力。

同时,开放平台将通过提供一系列非业务性的,例如测试工具、API调试工具、服务监控告警、日志分析统计等解决方案,让开发者专注于业务系统的开发,降低开发者的接入成本。



【授权说明】


应用接入开放平台需要获取商户的隐私数据(如账号、商品、订单、店铺信息等),为保证商户数据的安全与隐私,应用需要取得商户的授权,即获取访问商户数据的授权令牌 Access Token。因此,应用需要引导商户完成使用饿了么商家帐号“登录授权”的流程。该流程采用国际通用的OAuth2.0标准协议作为商户身份验证与授权协议。 

具体可参考:饿了么接口文档



【获取方式】


OAuth 2.0的运行流程如下图,摘自RFC 6749。


oauth2.0流程图

步骤如下:

  • (A)商户打开开发者的应用客户端以后,应用要求商户给予授权。

  • (B)商户同意给予应用授权,开放平台给应用颁发授权码。

  • (C)应用使用上一步获得的授权码,向开放平台的认证服务器申请访问令牌。

  • (D)认证服务器对应用进行认证以后,确认无误,返回访问令牌给到应用。

  • (E)客户端应用使用访问令牌,向开放平台的资源服务器申请访问数据资源。

  • (F)开放平台资源服务器确认访问令牌有效,同意向客户端应用开放资源。

根据应用的类型不同,授权分为客户端模式授权和授权码模式授权。

  • 如果使用商户账号登录开放平台且创建的个人类型应用,请使用OAuth2.0的客户端授权模式。

  • 如果注册了服务商账号,创建了企业类型的应用,需要使用OAuth2.0的授权码模式引导商户授权。

普通商户账号只能创建个人类型的应用,用于为自己的饿了么店铺进行功能开发。服务商账号目前只能创建企业类型的应用,可以为多个不同的商户提供服务。

授权请求入口地址


1)获取授权码(code)


2)获取访问令牌(access token)


注意事项:授权成功后得到的access_token正式环境有效期为30天,沙箱环境有效期是1天(expires_in的单位为秒),应用需要自行存储这个access_token,并且在每次接口访问前判断token是否失效(失效的判断逻辑是token已经过了expires_in的有效期或者接口调用返回的code为UNAUTHORIZED),如果失效需要重新授权获取,在有效期内token可以不能每次接口调用前都授权访问一次。有效期内重复授权访问会导致上一次的access_token失效。

授权码授权模式流程

企业类型的应用的开发是指企业独立完成应用的设计开发后,作为商品服务推广给商户使用。

需要注意的是,连锁店商户授权后所有连锁店的商户都会对该应用授权。


  • (A)商户访问客户端应用,后者将前者导向开放平台认证服务器。

  • (B)商户自行选择是否给予应用授权。

  • (C)假设商户给予授权,认证服务器将商户导向客户端事先指定的"重定向URI"(redirection URI),同时附上一个授权码code。

  • (D)客户端收到授权码,使用授权码向认证服务器申请访问令牌。这一步是在客户端的后台服务器上完成的,对商户不可见。

  • (E)认证服务器核对了授权码和重定向URI,确认无误后,向客户端发送访问令牌(access_token)和更新令牌(refresh_token)。

  • (F)假设商户拒绝授权,认证服务器将商户导向客户端事先指定的"重定向URI"(redirection URI),同时附上error信息

  • (G)在access_token即将过期之前,可以使用refresh_token直接向认证服务器发起请求,换取新的access_token,延续access_token的有效期

授权码模式各步骤详细说明:

此处以沙箱环境获取acccess_token为例说明,如果是正式环境请求,需将请求入口地址等相关数据换成正式环境对应入口地址,操作流程沙箱环境和正式环境是一致的。

实际进行授权操作时,测试的数据 client_id、secret、redirect_uri 等参数均需要根据自己创建的应用实际数据给予替换,不能拿示例中给出的值直接进行测试,以免影响实际测试效果。下图为服务端授权方式流程图,以下按流程图逐步说明。

授权流程

(A)步骤中,客户端拼接授权需要访问的URL,示例及参数说明如下:


授权链接



授权页面


(B)步骤引导商户到授权页,商户可以选择点击【同意授权】或者【取消授权】


(C)步骤获取授权码,如果商户点击【同意授权】,开放平台认证服务器会回应客户端的授权回调URI,并且返回参数


(D)步骤使用授权码换取访问令牌,客户端向认证服务器发起访问令牌的请求,示例及参数说明


(E)步骤,如果认证成功,认证服务器响应HTTP请求,Token示例如下:


{
  "access_token": "2YotnFZFEjr1zCsicMWpAA",
  "token_type": "bear",
  "expires_in": 3600,
  "refresh_token": "tGzv3JOkF0XG5Qx2TlKWIA",
  "scope": "all"
}


返回顶部

24小时客服热线:400-082-0366

扫一扫加微信好友

友情链接:网店管家

版权所有(C) 杭州笛佛软件有限公司 2016-2017 浙ICP备12017844号-10