提交报价
API 参考提交报价

提交报价

一次上传整笔询价的附件。收到 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_requirementsJSON 数组字符串 · 选填例如 [{"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。

幂等规则

网络超时或暂时失败时,使用原幂等键和原始请求重试,包括原来的附件顺序。相同请求返回同一任务及其当前状态。文件、顺序、数量、币种或备注变化时使用新键。

请求示例

提交 STEP 和 PDF
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,用于查询报价。

202 · 精简响应JSON
{
  "quote_id": "c89847f7-c145-4ffd-9df1-32d88d752501",
  "status": "received",
  "quantities": [10, 50],
  "currency": "CNY"
}