杭州杭景科技有限公司 调度骑士系统建设方案
成功时如下： {
\表示成功 \ \
\订单编号
\订单总价（根据传过来的商品，及配送费生成） } }
由于调度系统中没有商家的数据，所以订单中传输过来需要:商家名称、商家的地图定位数据（经纬度）、商家联系电话、商家地址等相关的数据
调用该接口需要增加一个状态通知url, 该url的功能和下面2.1.1中回调url 相同。
如果传入url, 返回值中需要带有secretkey, 用于回调该url 时作参数签名验证。如果该url已经注册为回调url, secretkey 不需要返回。
这个url的功能和下面的外部系统url 是一样的，只是针对该订单会覆盖注册的回调url .
调用返回：
1.1.2. 取消订单
在订单没有进入配送状态下（订单未调度），调用此接口，实现取消该订单，如果取消成功，返回成功取消，订单管理员将不会对此订单进行调度。如果不满足取消状态，返回取消失败，并给出失败原因。传入json数据。 URL 域名/api/Deliver/CancelOrder.aspx?orderid=15042115170997290 6 / 11
杭州杭景科技有限公司 调度骑士系统建设方案
参数 返回 orderid 订单编号 失败情况 { \非0表示失败 \此订单已经开始配送，不能取消\错误信息 } 成功情况 { \ \}
1.1.3. 删除订单
在系统完成配送成功(订单状态为成功的订单)的情况下，用户可以申请删除订单，杭景系统根据订单ID，删除此订单，并返回删除成功。 URL 参数 返回 域名/api/Deliver/DeleteOrder.aspx?orderid=15042115170997290 orderid 订单编号 失败情况 { \非0表示失败 \参数不完整\错误信息 } 7 / 11
杭州杭景科技有限公司 调度骑士系统建设方案
成功情况 { \ \}
1.1.4. 订单状态更新通知接口
【目前未开发此接口，我们在系统后台已经开发了第三方的接口管理系统，可以管理appid key等信息，所以就无需此接了，效果是一致的，请查看后台】
通知需要使用回调url 来实现， 调度系统（杭景系统）需要提供一个注册接口
http://原系统地址/Api/RegisteOrderStatusNotify.aspx?callback=url 在杭景系统的订单调度的状态发生变化的时候通过这个url 通知最新状态 回调需要参数： orderid=xxxxx&oldstatus=x&status=y&sign=xxxxxxx
调用注册接口注册成功后需要返回secretkey, 用于回调该url 时作参数签名验证。不同的回调地址，对应的secretkey 应不同。
订单状态是存放在杭景系统里面的，订单物流状态更新也是杭景调度系统操作，在订单物流状态变化时，外界其它系统需要获知该变化，外界系统只能提供一个url, 注册给杭景系统，在调度系统更改订单物流状态后，通过这个url 通知外界系统订单物流变化。
目前状态值按照杭景系统的状态
8 / 11
杭州杭景科技有限公司 调度骑士系统建设方案
1.1.5. 订单状态更新通知接口
1、订单状态更新接口地址：
http://原系统地址/Api/甲方通过接口注册的地址?orderid=1&status=2 返回数据：{“orderid”:”1”,”success”:”true/flase”} 2、http get方式 3、数据定义
orderid为传输过来的订单唯一编号 status为双方最终确认的订单调度的状态： 0、待调度 1、已经调度 2、骑士接收 -1 骑士拒收 3、配送完成
1.2. api认证
具体流程如下：
1，通过appid，appkey获取token（目前过期时间为1小时） 2，每个请求都添加token参数。
1.2.1. 后台设置appid,appkey
每个第三方可设置appid,appkey,及通知url
9 / 11
杭州杭景科技有限公司 调度骑士系统建设方案
1.2.2. 获取token
URL 参数 域名/api/Deliver/token.aspx?appid=001&appkey=YK appid 杭景后台生成 appkey杭景后台生成 返回 失败情况 { \表示正常，其他都是失败 \或者appkey不正确\说明信息 10 / 11
杭州杭景科技有限公司 调度骑士系统建设方案
} 成功情况 { \表示成功 \ \ \过期时间 \ } }
2. 附录
2.1. 支付方式
货到付款 4 支付宝 1
附录信息
11 / 11
相关推荐：
loading