# 授权说明
接入开放平台需要获取商户的隐私数据(如账号、商品、订单、门店信息等),为保证商户数据的安全与隐私,需要取得微播商户的授权,即获取访问商户数据的授权令牌 Access Token。因此,应用需要引导商户完成使用微播商户帐号“登录授权”的流程。该流程采用国际通用的OAuth2.0标准协议作为商户身份验证与授权协议。
# 授权流程
1. 使用GET请求跳转至授权跳转地址
2. 登录授权商户账号密码
3. 授权成功后向开发者授权回调地址发送POST请求,并跳转至开发者授权回调地址
# 授权跳转地址
http://waimai.wboll.com/authorized/authorize
get请求参数:
| 字段名称 | 说明 |
| --- | --- |
| app_id | 开发者ID |
| callback_url | 授权回调地址 |
| sign | 签名(签名方式见1.2 签名方式章节) |
| timestamp | unix timestamp (说明:10位UNIX时间戳) |
响应:
| 字段名称 | 说明 |
| --- | --- |
| access_token | 授权成功的access_token |
| expires_in | access_token有效时间 |
| refresh_token | access_token刷新凭证 |
| expires_refresh_in | refresh_token有效时间, 比access_token有效时间长,避免刷新token失败 |
> **授权说明**
> 授权成功后,首先 `微播服务器` 给 callback_url POST 授权 token 等参数,然后浏览器跳转(302)到 callback_url 上(不携带参数)
POST数据示例
```js
access_token=d5a187d506426cs9e318081087b3ed4ef9630deb
expires_in=2592000
refresh_token=ab4438baad69ba59dc9c5bc9a24a3a09
expires_refresh_in=3888000
```
# 请求示例
http://waimai.wboll.com/authorized/authorize?app_id=123456&callback_url=http%3A%2F%2Furl.com×tamp=1524193355&sign=534E62B5E59C6CF7928A9A2984161F83
- 开放平台简介
- 一、快速开始
- 1.1 数据交互
- 1.2 签名方式
- 1.3 商户授权
- 1.4 刷新token
- 1.5 常见问题
- 二、消息推送服务
- 2.1 消息推送介绍
- 2.2 新订单推送
- 2.3 堂食新订单
- 2.4 堂食加菜
- 2.5 堂食退菜
- 2.6 订单已取消
- 2.7 订单完成
- 2.8 发生部分退款
- 2.9 订单配送中
- 2.10 订单已送达
- 2.11 订单配送异常
- 2.12 直接买单
- 2.13 待自提
- 2.14 已接单
- 三、订单管理
- 3.1 查看订单详情
- 3.2 取消订单
- 3.3 配送订单
- 3.4 确认送达/自提订单
- 3.5 接单
- 四、门店管理
- 4.1 获取门店列表
- 4.2 获取门店信息
- 五、商品管理
- 5.1 新增分类信息
- 5.2 更新分类信息
- 5.3 查询分类信息
- 5.4 删除分类信息
- 5.5 查询商户所有分类信息
- 5.6 新增商品信息
- 5.7 更新商品信息
- 5.8 查询商品信息
- 5.9 删除商品信息
- 5.10 查询分类下所有商品
- 5.11 查询商户所有分类及其商品
- 5.12 上传图片
- 六、餐单管理
- 6.1 新增品牌餐单
- 6.2 更新品牌餐单
- 6.3 获取餐单列表
- 6.4 删除餐单
- 6.5 餐单推送
- 八、附录
- 九、OpenAPI更新记录