# 通信说明
接⼝通信使⽤ 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更新记录