闪送 API 联调快速开始
- 开发者人工执行
updatesql/sql.md 中既有闪送迁移及 2026-09-07 统一运价增量，核对每个时段的加急比例和最低加急费；并在字典 sys_google_routes_key 配置仅供后端使用、已启用 Google Routes API 的独立密钥，不得复用匿名接口可读取的 sys_googlemap_key。
- 启动
ruoyi-admin；用户和骑手请求携带现有 token 请求头，平台请求使用后台权限。
- 调用
/system/flashDelivery/home、/quote、/orders；报价提交帮送/帮取业务场景、普通/加急配送等级、立即/预约取件时段、完整物品信息和骑手小费。创建时回传报价 ID、版本及各项金额，服务端复算不一致时返回最新报价且不创建订单；收件账号匹配结果固化在新订单中，不追溯历史订单。
- 用户通过
/system/flashDelivery/orders?role=sender 查看“我发的”，通过 role=receiver 查看“我收的”；省略 role 时默认 sender。发件人与固化收件人均可查看详情和确认收货，只有发件人可以取消。
- 骑手从
/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。
deliveryType=URGENT 的急送接单与外卖、普通闪送共用骑手级 Redis 锁；急送进行期间骑手不能承接其他配送，接急送前骑手也不能有任何进行中配送。- 发布成功页使用静态文案“发布后等待附近骑手接单”，不展示动态附近骑手数或承诺接单时间。闪送不接入支付，金额保持整数 TWD。
- 用户
/confirmReceipt 完成；送达满 24 小时未操作则自动完成。
- 完整字段见 API 契约。
