送件侠开放平台

闪时送开放平台


!!!必看 - 快速联调

<h3>快速联调主流程:</h3> <pre><code>1. 调用查询余额接口,查看接口是否响应正常 --- 这一步可以用附录内的demo代码,快速验证接口签名是否正常 2. 调用同步门店接口, 完成门店创建 (如果是基础套餐的,请使用`绑定门店`接口) 3. 调用计算运费接口,获取支持配送的所有运力列表 4. 调用下单接口 5. 根据订单回调信息mock,处理完业务方逻辑 6. 正式发单测试</code></pre> <h3>特别说明</h3> <pre><code>1. 合作方都会赠送20元余额,用于测试发单 2. 目前不再使用测试环境接口,因为配送方会针对测试环境做发件区域、订单状态限制,反而影响真实性并且不利于调试。 所以,前期测试时,门店位置可选择城市偏僻的地方,避免测试时被骑手快速接单。 3. 送件侠已做多运力同时发单的幂等处理,所以不会存在一个订单同时被多个运力方所接单 4. 配送API不支持压测场景,禁止合作方压测场景直接调用</code></pre> <h3>接口调用分解说明</h3> <pre><code> 1. 调用`查询余额`接口,可以参考附录内的demo代码, 如果接口返回code=0,就表示正常通了,签名也没问题 - 因为生成签名往往是对接最麻烦的事 2. 调用`同步/绑定门店`接口(如果是基础套餐的,请使用`绑定门店`接口), 测试阶段,在创建门店时可以选择偏僻的地方(比如山上、风景区),这样后续下单也不用担心被骑手接单影响调试, 如果成功将得到一个sss_shop_id, 这表示开发者与此门店已映射成功 3. 调用`计算运费`接口,特别注意有些参数是不需要参与签名的, 如果有返回结果,注意sss_peisong_id, 后续调用下单接口时需要 4. 调用`下单接口`,将第3步的sss_peisong_id带上 5. 根据`订单状态回调`的demo返回数据,稍微改一改,模拟向回调地址推送`已接单`、`配送中`、`已完成`的内容, 处理好业务侧的逻辑, 其中`获取骑手位置`也可以一并通过mock数据测试掉 6. 如果自测没啥问题了,就可以开始真实下单(换个门店地址),让骑手接单并完成, 这样跑几次订单后如果链路没问题就OK了。 </code></pre>

页面列表

ITEM_HTML