# 通信說明
接?通信使? HTTPS ?式,保證數據傳輸的安全性,參數通過 HTTP POST 發送OpenAPI。
發送 HTTP 請求的時候,需要帶上 `access_token` 和 `timestamp` 和 `app_id` 參數。
請求https方式: `https (POST方式) `
請求數據類型: `application/x-www-form-urlencoded `
字符編碼格式: `utf-8`
# 參數命名約定
- app_id,開發者ID,由微播餐飲分配,如:10001996
- app_secret, 商戶秘鑰,由微播餐飲分配,如:b1844eea765f6d6038229727b3541122
- timestamp,unix timestamp (說明:10位UNIX時間戳)
- params, 請求具體接口參數,(如:order_id, type)
- sign_str 待簽名的字符串,sign = md5(sign_str)
- sign 請求簽名
# 請求通用參數列表
| 字段名稱 | 說明 |
| --- | --- |
| app_id | 商戶ID |
| access_token | 訪問令牌token |
| timestamp | unix timestamp (說明:10位UNIX時間戳) |
| ... | 其他參數,如order_id, type |
# 接口服務器地址
正式環境:https://apib7.wboll.com
# 數據格式約定
接口響應數據采用 `JSON` 的方式
```js
{
"head": { "code": 200, "msg": "" },
"body": {
// 詳細接口響應數據
}
}
```
返回狀態碼說明
- 200 操作成功
- 非200 執行失敗,執行失敗碼詳見 [八、附錄](other.md)
- 開放平臺簡介
- 一、快速開始
- 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更新記錄