quickstart.md 1.2 KB

闪送 API 联调快速开始

  1. 开发者人工执行 updatesql/sql.md 中 2026-08-31 闪送迁移,并在字典 sys_google_routes_key 配置仅供后端使用、已启用 Google Routes API 的独立密钥;不得复用匿名接口可读取的 sys_googlemap_key
  2. 启动 ruoyi-admin;用户和骑手请求携带现有 token 请求头,平台请求使用后台权限。
  3. 调用 /system/flashDelivery/home/quote/orders;创建时服务端重新报价。
  4. 骑手从 /system/flashDelivery/rider/orders?page=1&size=10&tab=newTask&longitude=121.5&latitude=25.0 拉取待抢任务并调用 /accept;五个页签分别为 newTask(待接单)、toPickup(已接单)、delivering(已取件)、completed(已送达/已完成)和 cancelled(已取消)。newTask 的经纬度仅用于附近范围、取件点距离和排序,闪送没有 refund 页签。接单前只展示完整文字地址,隐藏联系人、电话、实际 PIN、精确坐标和履约图片;图片先走现有上传接口,再把 URL 传给 /pickup/deliver
  5. 用户 /confirmReceipt 完成;送达满 24 小时未操作则自动完成。
  6. 完整字段见 API 契约