# 闪送 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 契约](contracts/api.md)。