一、同步下单接口
POST /api/v1/order
请求参数（application/x-www-form-urlencoded）
| 参数名 | 必填 | 说明 |
|---|
product_id | 是 | 商品ID（依次匹配：系统编号 → 数据库ID → goods_id） |
phone_number | 是 | 联系电话 |
cert_name | 是 | 证件姓名 |
cert_id | 是 | 证件号码（身份证） |
post_addr | 是 | 收货详细地址（文字） |
post_province | 否 | 收货省编码（如 510000；不传用商品配置） |
post_city | 否 | 收货市编码（如 510100；不传用商品配置） |
post_district | 否 | 收货区县编码（如 510107；不传用商品配置） |
city_code | 否 | 选号城市编码（不传用商品配置） |
developer_id | 否 | 开发者ID（不传用商品配置） |
photo_front | 否 | 身份证正面（base64 或 URL） |
photo_back | 否 | 身份证反面（base64 或 URL） |
photo_face | 否 | 人脸照（base64 或 URL） |
idempotency_key | 否 | 幂等键（防重复提交） |
返回参数
{
"code": 0, // 0成功/1失败/1001无Cookie/1003Cookie过期
"msg": "下单成功",
"data": {
"order_id": 18356, // 系统订单ID
"orderId": "xxxx", // 联通订单ID
"selected_number": "15680840087", // 选购号码
"upload_url": "https://...", // 证件上传链接
"cert_name": "丁丽梅",
"cert_id": "360731200003102928",
"phone_number": "16608025837",
"cookie_phone": "16608025837", // 使用的Cookie手机号
"photo_status": "success"
}
}
示例
curl -X POST "https://xinst.10010hk.vip/api/v1/order" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "product_id=816208116490" \
-d "phone_number=13800138000" \
-d "cert_name=张三" \
-d "cert_id=110101199001011234" \
-d "post_addr=四川成都市锦江区锦江科技大学1栋2单元" \
-d "post_province=510000" \
-d "post_city=510100" \
-d "post_district=510107"
二、异步队列下单接口
队列特性：一笔一笔顺序处理、任务持久化（重启不丢失）、完成自动回调。
1. 提交任务
POST /api/v1/order/async
参数同同步接口，额外：
| 参数名 | 必填 | 说明 |
|---|
callback_url | 是 | 任务完成后的回调地址 |
{"code": 0, "task_id": "9b150396916d4ff6", "msg": "任务已提交"}
2. 查询任务
GET /api/v1/order/async/{task_id}
{
"code": 0,
"data": {
"task_id": "9b150396916d4ff6",
"status": "success", // pending/processing/success/fail
"result_code": "0000",
"result_msg": "下单成功",
"result_data": {...},
"callback_status": "success", // pending/success/fail/retrying
"callback_result": "成功 HTTP200",
"created_at": "2026-07-11 14:49:00",
"updated_at": "2026-07-11 14:53:40"
}
}
3. 任务列表
GET /api/v1/order/async/list?page=1&size=15&status=&search=
4. 回调内容（POST 到 callback_url）
{
"task_id": "9b150396916d4ff6",
"status": "success",
"result_code": "0000",
"result_msg": "下单成功",
"data": { ...下单返回数据... }
}
回调机制：首次等待60秒（给下游写入时间），失败自动重试3次（间隔60s/30s/120s）。