欢迎来到 Quote3D 文档！⏳
Quote3D LogoQuote3D文档

3D 打印报价 API 快速上手

在不到 5 分钟内即可快速上手 Quote3D API！如需进行外部集成，请从 https://api.quote3d.com/v2 调用端点。请按照以下步骤创建您的账户、生成 API 令牌并开始进行您的首次 API 调用。

1

创建您的账户

  1. 访问 Quote3D 控制面板以注册一个新账户
  2. 填写注册表格，提供您的详细信息 填写注册表格，提供您的详细信息
  3. 检查您的电子邮件并点击确认链接以完全激活您的账户 检查您的电子邮件并点击确认链接以完全激活您的账户

请务必确认您的电子邮件地址，否则您的账户将无法完全激活，您将无法访问 API！

2

生成您的 API Token

  1. 登录您的 Quote3D 账户
  2. 导航到仪表盘 - 登录后您将自动重定向到此处
  3. 点击左侧边栏中的“Tokens”选项卡 点击左侧边栏中的“Tokens”选项卡
  4. 通过点击“新建 Token”按钮创建新的 Token
  5. 配置您的 Token：
    • 为其指定一个描述性名称（例如，“我的第一个 Token”）
    • 设置有效期（天数），留空则表示没有有效期
  6. 立即复制生成的 Token 并安全地存储它

您只会看到一次令牌！请务必在关闭弹出窗口之前复制并保存在安全的位置。

3

使用 API 进行身份验证

  1. 导航到 /docs/playground 的 API 游乐场
  2. 点击右上角的锁图标 点击右上角的锁图标
  3. 将步骤 2 中的 JWT 令牌粘贴到授权字段中
  4. 点击授权 Authorize

恭喜！您现在已通过身份验证，可以探索 Quote3D API 了。

4

发起您的第一个 API 调用

准备好测试了吗？尝试上传您的第一个 STL 文件：

  1. 在 API 文档中找到 POST https://api.quote3d.com/v2/file 端点
  2. 展开标签以显示 POST 请求详情
  3. 使用“选择文件”按钮上传 STL 文件，以打开您的文件资源管理器
  4. 执行请求 执行请求

响应将包含一个文件 ID，您可以使用它来：

  • 检查尺寸和可打印性
  • 生成报价，以获取自动即时定价估算
  • 管理上传的文件，以节省您的云存储空间

file_id 是您管理和引用后续 API 调用中上传文件的关键标识符。它是所有其他 API 调用所基于的唯一标识符。

端点决策树

在决定 https://api.quote3d.com/v2 上下一个要调用的端点时，请使用此快速路径。

  1. 需要从您的后端进行上传吗？ 使用 POST https://api.quote3d.com/v2/file，并使用您的 Bearer token。
  2. 需要在不暴露 Token 的情况下直接通过浏览器上传吗？ 通过 GET https://api.quote3d.com/v2/file/upload-id 获取上传 ID，然后通过 POST https://api.quote3d.com/v2/file/public/{upload_id} 进行上传。
  3. 定价前需要进行尺寸/配合验证吗？ 调用 POST https://api.quote3d.com/v2/printability/{file_id}。
  4. 需要报价吗？ 从 POST https://api.quote3d.com/v2/file/quote/{file_id} 开始。
  5. 等待报价完成？ 轮询 GET https://api.quote3d.com/v2/jobs/{job_id}，直到状态变为 completed、failed 或 cancelled。状态值为小写，且失败的任务仍会返回 HTTP 200。
  6. 需要已存储的报价历史/详情吗？ 使用 GET https://api.quote3d.com/v2/quotes 和 GET https://api.quote3d.com/v2/quotes/{quote_id}。

注意： 如果您在报价请求中未发送技术、打印机或材料详情，API 将回退至您的默认用户配置文件设置。

常见错误及应对措施

针对最常见边缘情况的快速操作。

429 速率限制： 读取 X-RateLimit-* 和 Retry-After 响应头，等待，然后使用指数退避算法进行重试。

文件格式无效： 仅支持上传 STL、3MF、OBJ 或 STEP（.step/.stp）格式。请重新导出模型并验证文件完整性。

模型超出打印平台范围： 请先运行可打印性检查，减小模型比例，或选择更大的打印机配置/成型体积。

单位异常警告： 您的模型可能使用了英寸/米单位。请以毫米（mm）为单位重新导出并重试。

接下来是什么？

现在您已经设置完毕，请探索这些关键功能：

  • 文件管理 - 上传、下载和管理您的 3D 模型文件（STL, 3MF, OBJ, STEP）
  • 可打印性检查 - 验证您的模型是否符合您的打印机尺寸
  • 报价生成 - 以您首选的货币获取即时定价，并提供详细的材料用量和打印时间估算
  • 报价历史 - 访问并管理您所有的历史报价
  • Webhooks - 接收有关报价完成和文件上传的实时通知
  • 分析 - 跟踪您的使用情况、常用材料和成本趋势
  • 账户管理 - 监控您的配额、使用统计信息和订阅详情

接下来阅读

重要：每个端点都需要您的 API 令牌，以 Authorization: Bearer TOKEN 或 X-API-Token: TOKEN 发送。唯一的例外是 POST /v2/file/public/{upload_id}，即浏览器上传，它改用一次性上传 ID。

示例： Authorization: Bearer YOUR_TOKEN_HERE

需要帮助？请查看我们的核心概念指南或探索 API Playground 以获取交互式文档。