开发接口文档
  1. 其他
开发接口文档
  • 快跑者开放接口文档
    • 前言
      • 文档说明
      • 订单创建商户映射逻辑
      • 签名生成规则
    • 订单相关接口
      • 计算配送费
      • 创建订单
      • 获取订单详情
      • 获取订单进程
      • 获取订单配送员坐标
      • 订单增加小费功能
      • 配送订单出餐
      • 撤销订单
      • 评论配送员
      • 拉黑骑手
    • 联盟订单相关接口
      • 计算配送费
      • 创建订单
    • 团队相关接口
      • 获取团队信息
    • 商户相关接口
      • 获取所有商户
      • 解绑授权商户
      • 设置商家名称
      • 创建关联快跑者商户
      • 获取商家储备金余额及充值链接
      • 获取指定团队是否存在相关商户
    • 门店相关接口
      • 获取门店列表
      • 修改门店
      • 删除门店
      • 关联门店
    • 配送员相关接口
      • 获取所有配送员
      • 获取指定范围配送员
      • 解除拉黑骑手
    • 回调通知
      • 配送订单状态变更回调
    • 其他
      • 常见问题
      • 微盛小程序对接快跑者
  1. 其他

常见问题

常见问题说明#

Q1. 开发密钥(dev_key)和签名密钥(dev_secret)从哪儿获取?#

在 快跑者开放平台 注册开发者账号,完善 资质认证 信息,并绑定微信(申请通过会通过微信进行通知)。
快跑者的工作人员通过审核之后,即可在「接口配置」页面查看开发密钥(dev_key)和签名密钥(dev_secret):

Q2. 团队密钥(team_token)分别从哪儿获取?#

可以注册一个测试用的 快跑者配送团队账号(七天免费试用期),在「团队管理 - 团队信息页面」即可查看团队密钥(team_token):

注:每个快跑者配送团队有一个唯一的团队密钥(team_token)

Q3. 错误提示:该商户已绑定其他团队#

第三方系统在调用创建订单接口时,会将订单匹配一个对应的快跑者商户(具体的匹配逻辑参考:订单创建商户映射逻辑),但在快跑者系统中,一个商户同一时间只能和一个配送团队合作,如果对应的快跑者商户已经和其他配送团队合作,那么将会提示:该商户已绑定其他团队。
解决办法:在快跑者官网下载快跑者商户端 APP,使用 shop_tel 对应的手机号码登录快跑者商户账号(密码默认和手机号码一致),然后在「合作团队页面」查看和解绑合作团队:

Q4. 错误提示:密钥认证异常#

可以登录快跑者开放平台,在验证签名中放入签名参数进行查看签名过程与开发者自身签名过程是否一致,结果是否一样。在参数传递过程中,使用get方式时,请将参数进行url_encode后进行签名。系统在签名过程中会将转义字符转义回去。

Q5. 错误提示:商户未授权#

在绑定请求接口对应的team_token团队中团队调度后台,在商户->商户授权管理->聚合平台授权配置下给指定商户授权即可。
上一页
配送订单状态变更回调
下一页
微盛小程序对接快跑者
Built with