接口接入

把打印体检与修复接入业务系统

使用同一套打印体检、网格修复、强力重建和 CAD 出片任务内核。密钥仅能访问当前账号的打印准备任务，不能访问模型库、账单或管理接口。

接入密钥

正在读取密钥…

提交任务

BASE_URL="${PRINTREADY_BASE_URL:-http://localhost:3000}"
curl -X POST "$BASE_URL/api/cae-mesh" \
  -H "Authorization: Bearer $PRINTREADY_API_KEY" \
  -H "Idempotency-Key: 8c7f9b84-93d1-4b2f-a032-example" \
  -F "file=@part.stl" \
  -F 'options={"printReady":{"workflow":"repair","unit":"millimeter","process":"fdm-standard","geometryPolicy":"preserve","repairToleranceMm":0}}'
# 查询（从提交响应保存 JOB_ID）
curl "$BASE_URL/api/cae-mesh/$JOB_ID" \
  -H "Authorization: Bearer $PRINTREADY_API_KEY"

# 取消活动任务
curl -X DELETE "$BASE_URL/api/cae-mesh/$JOB_ID" \
  -H "Authorization: Bearer $PRINTREADY_API_KEY"

# 下载：使用查询响应中 artifacts[].downloadUrl
curl -OJ "$BASE_URL$DOWNLOAD_URL" \
  -H "Authorization: Bearer $PRINTREADY_API_KEY"
workflow
check 体检 · repair 网格修复（小缝/非流形）· rebuild 大洞重建 · cad-to-print CAD 出片
process
fdm-draft 熔融堆积快速 · fdm-standard 标准 · fdm-fine 精细 · resin 树脂

任务生命周期

  1. GET /api/cae-mesh/:id 查询进度、评级和产物。
  2. DELETE /api/cae-mesh/:id 取消排队或处理中任务。
  3. 完成响应中的 artifacts[].downloadUrl 用同一 Bearer 密钥下载。
  4. 单用户默认最多两个活动任务，产物默认保留七天。

常见响应：401 密钥无效或过期；409 并发上限或任务已结束；429 请求过快； 410 产物已过期。失败响应均包含可展示的 error。

常见问题

接口支持哪些任务类型？

与网页版一致：可打印体检、网格修复（含工艺重划）、扫描件强力水密重建、CAD 高精度出片。每类任务独立配额与作用域，可按需授权。

如何获取 API 密钥？

登录后在接口页面创建密钥，选择允许的任务类型与有效期。密钥只显示一次，请妥善保存；泄露可随时吊销重建。

任务是同步返回还是异步？

异步。提交后立即返回任务 ID，通过轮询接口查询状态，完成后下载 3MF / STL 结果或读取体检报告 JSON。大文件建议设置合理轮询间隔。

上传的文件会保留多久？

任务产物默认保留七天后自动清理，源文件随任务一起管理；不会用于训练或对外共享。企业私有化部署可完全离线运行。