提交报价
一次上传整笔询价的附件。收到 HTTP 202 后,保存任务编号用于后续查询。
POST
/v1/quotes本页内容
请求参数
请求体使用 multipart/form-data。每个附件都使用 files 字段。cURL 和 Python 示例会自动生成 Content-Type 和 boundary。
| 字段 | 类型与要求 | 说明 |
|---|---|---|
Idempotency-Key | 请求头 · 必填 | 1–128 个可见 ASCII 字符。同一笔请求重试时复用,内容变化时用新键。 |
files | 文件 · 必填 | 重复传同一个字段。每次 1–50 个附件,每个最多 80 MiB,附件合计最多 300 MiB。 |
quantity / quantities | 整数或 JSON 数组字符串 · 选填 | quantity=17 表示所有未单独指明的零件各 17 件;quantities=[4,8,32] 表示多个情景。二选一,最多 7 档,每档 1–10,000,000 件。均省略且无 Excel 时使用 1、10、100、1000 件。 |
currency | 字符串 · 选填 | 支持 CNY、USD、EUR、GBP、JPY,默认 CNY。外币按明确的换算汇率计算,返回汇率来源和参考日期。 |
exchange_rate | 数字 · 选填 | 1 单位报价币种等于多少人民币。外币省略时使用带日期的参考汇率。 |
material / process | 字符串 · 选填 | 整单材质和工艺要求,逐件指定时以逐件要求为准。没有匹配路线时返回具体问题。 |
part_requirements | JSON 数组字符串 · 选填 | 例如 [{"drawing_no":"QM-001","revision":"A","quantity":17,"material":"6061-T6","process":"CNC_MILL_3AX"}]。用完整图号或 filename 对应零件,可加 revision。Excel 优先;无 Excel 时,逐件数量优先于整单数量。 |
notes | 字符串 · 选填 | 最多 2,000 字符。可补充材质、公差、表面处理和特殊要求。 |
billing_mode | 字符串 · 选填 | 正式站使用默认 trial_only。本地支付联调可使用 auto。 |
幂等规则
网络超时或暂时失败时,使用原幂等键和原始请求重试,包括原来的附件顺序。相同请求返回同一任务及其当前状态。文件、顺序、数量、币种或备注变化时使用新键。
请求示例
curl "https://aibaojia.creating5dreams.com/v1/quotes" \
-H "Authorization: Bearer $QIANFEI_API_KEY" \
-H 'Idempotency-Key: rfq-202611-001' \
-F 'files=@QM-001-A.step' \
-F 'files=@QM-001-A.pdf' \
-F 'quantities=[10,50]' \
-F 'currency=CNY'收件响应
202 Accepted 表示后台已收件。保存 quote_id,用于查询报价。
{
"quote_id": "c89847f7-c145-4ffd-9df1-32d88d752501",
"status": "received",
"quantities": [10, 50],
"currency": "CNY"
}