# 授權說明
接入開放平臺需要獲取商戶的隱私數據(如賬號、商品、訂單、門店信息等),為保證商戶數據的安全與隱私,需要取得微播商戶的授權,即獲取訪問商戶數據的授權令牌 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更新記錄