小智回收自助下单
Overview
通过小智回收开放平台 REST API 完成自助下单，将回收设备信息（品牌、型号、品类）、联系人、上门地址等信息提交到回收系统。
触发场景
- 用户说「帮我提交一个回收订单」
- 用户提供设备信息要求「小智回收下单」
- 用户需要「获取回收报价并下单」
- 用户询问「怎么自助回收XX设备」
API 认证方式
认证信息通过 HTTP Header 携带，Token 由脚本自动生成，详细逻辑见 scripts/create_order.py。
下单流程
Step 1: 收集订单信息
向用户确认以下必要信息，缺失则逐一询问：
| 字段 | 说明 | 示例 |
|---|---|---|
name |
联系人姓名 | 张三 |
mobile |
联系电话 | 13800138000 |
prov_name |
省份 | 北京 |
city_name |
城市 | 北京市 |
area_name |
区/县 | 朝阳区 |
address |
详细地址 | XX路XX号 |
item_brand |
设备品牌 | 华为 |
item_cates |
设备品类 | 手机 |
item_model |
设备型号 | Mate 60 Pro |
remark |
备注（可选） | 期望上门时间 2026-06-10 |
以下字段使用默认值，无需向用户询问：
- price: 固定 0.01
- source: 固定 172
- sale_item_name: 自动取 item_cates 的值
Step 2: 确认并提交
信息收集完成后向用户展示订单摘要，等用户确认后再提交。
Step 3: 调用下单接口
使用 scripts/create_order.py 脚本提交订单：
python3 scripts/create_order.py \
--name "张三" \
--mobile "13800138000" \
--prov-name "北京" \
--city-name "北京市" \
--area-name "朝阳区" \
--address "XX路XX号" \
--item-brand "华为" \
--item-cates "手机" \
--item-model "Mate 60 Pro" \
--price "0.01" \
--remark "期望上门时间 2026-06-10 | 屏幕完好"
也可先用 --dry-run 验证 Token 和参数：
python3 scripts/create_order.py \
--name "张三" \
... \
--dry-run
Step 4: 解析响应
成功时返回 JSON 响应体，从中提取订单号等信息展示给用户。失败时根据 HTTP 状态码和错误信息排查原因。
若返回「该询价信息已下单，请勿重复使用」，说明该询价对应的订单已存在，需要新的询价记录。
关键注意事项
- 信息收集完成后向用户展示订单摘要，确认后再提交
- 若返回「该询价信息已下单，请勿重复使用」，说明该询价对应的订单已存在，需要新的询价记录
Resources
scripts/create_order.py
下单核心脚本，可直接执行，也可被 import 使用。
references/api.md
API 接口参考文档，包含参数说明和请求示例。
