🔌 API SERVICE
鲜花速递 API 接口对接
提供鲜花商品价格、鲜花品类、城市配送、下单、订单状态等全套业务数据接口，不限制对接场景，H5、微信小程序、APP 均可接入。
CAPABILITY
接口能力清单
你需要的鲜花业务能力，接口层全部覆盖
| 能力模块 | 接口内容 | 典型用途 |
|---|---|---|
| 鲜花商品价格 | 花束列表、详情、实时价格、库存状态 | 搭建自有商品列表页与详情页 |
| 鲜花品类 | 花材分类、场景分类、标签数据 | 实现分类导航与筛选 |
| 城市配送 | 可配送城市列表、配送范围与时效校验 | 下单前判断能否送达、给出时效 |
| 下单 | 创建订单、收货人信息、配送时间指定 | 完成从选品到提交订单的闭环 |
| 订单状态 | 订单查询、配送进度、状态流转回调 | 订单列表与实时配送进度展示 |
🎯 对接场景
我方 API 不限制对接场景，只要你有流量入口，都可以把鲜花业务接进去。
🧭 对接流程（7 步上线）
1
确定对接意向
沟通合作需求，确定 API 对接意向与方案
2
签署 API 接口合同
明确双方权责，保障合作权益
3
建立技术对接群
双方技术人员进群，高效沟通协作
4
发送 API 接口文档及秘钥
获取完整接口文档与专属秘钥
5
模拟测试下单
联调测试，验证下单全流程
6
提供管理后台
该后台仅提供资金明细对账及充值记录使用
7
正式上线
测试通过后正式上线，开启鲜花业务变现
🎁 月均有效订单 320 单以上，第二年免费
API 收费标准（按年收费）
¥3888/年
鲜花 20% 分佣，不限对接场景
- ✔ 商品价格 / 品类 / 配送 / 下单 / 订单状态全套接口
- ✔ 支持 H5、小程序、APP 多场景对接
- ✔ 配套管理后台，资金明细对账清晰
- ✔ 月均有效订单 320 单以上，第二年免费
接口调用形态
接口采用标准的 HTTPS + JSON 形式提供，通过专属秘钥完成鉴权。所有接口均为服务端调用，不需要在前端暴露任何密钥信息。以下为下单接口的请求形态示意（字段以实际接口文档为准）。
POST /api/flower/order/create
Content-Type: application/json
Authorization: Bearer {你的专属秘钥}
{
"goods_id": "10086",
"city": "郑州",
"receiver_name": "张先生",
"receiver_phone": "13800000000",
"receiver_address": "金水区XX路XX号",
"delivery_date": "2026-09-20",
"delivery_time_range": "09:00-12:00",
"remark": "请附赠卡片：生日快乐"
}返回结果包含订单号与订单状态，后续通过订单查询接口或状态回调获取配送进度。接口文档在签署合同后随专属秘钥一并提供。
对接前的技术准备
- 服务端具备公网 HTTPS 调用能力，能处理 JSON 请求与响应。
- 如需接收配送状态变更，需要一个可公网访问的回调地址。
- 建议具备基础的订单重试与幂等处理逻辑，避免重复下单。
- 不限制技术栈，PHP、Java、Python、Node.js、Go 等均可对接。
费用与续费政策
API 接口按年收费，标准费用 3888 元/年，包含全套业务数据接口与专属秘钥。佣金按订单金额的 20% 结算。API 接口对接需预存资金，具体额度与形式以双方签署的协议为准，不额外收取保证金。
如果月均有效订单达到 320 单以上，第二年免收接口费用。这一政策的目的是让真正跑出量的合作方长期零成本使用接口。
API 对接和小程序合作怎么选
| 你的情况 | 推荐方案 |
|---|---|
| 没有技术团队，只想快速上线变现 | 小程序 CPS 合作（299 元/年） |
| 已有 App / H5 / 商城，想把鲜花作为新品类接进去 | API 接口对接（3888 元/年） |
| 想用自有品牌界面，完全定制视觉与交互 | API 接口对接 |
| 需要接入多个渠道、统一订单管理 | API 接口对接 |
| 先小规模试水，验证流量是否能出单 | 小程序 CPS 合作，跑通后再转 API |
常见疑问
对接需要多久？
流程本身是 7 步，实际周期取决于双方技术人员配合速度。接口文档齐全的情况下，常见的联调周期在几天到两周之间。
可以只对接部分接口吗？
接口按整套提供，不做拆分。这是因为下单链路本身需要商品、配送、订单几组接口协同才能跑通。
管理后台能看到什么？
管理后台仅用于查看资金明细对账与充值记录，不包含商品管理功能，商品数据通过接口实时获取。
第二年免费的口径是什么？
以自然年月均有效订单量为准，月均有效订单 320 单以上即满足免费续期条件。有效订单指已完成配送并通过售后期的订单。
MORE
