Skip to content
CurriculoCurriculo ATS DocumentationDocs
API referenceConsole

错误

On this page

错误是 JSON 并携带重要的 HTTP 状态。没有错误会默默失败：被拒绝的请求会告诉你原因。每个响应都携带一个 X-Curriculo-Request-Id 标头；当你联系我们时，请引用它。

错误格式

边缘拒绝（身份验证、信用、速率限制、超大请求）返回：

{"success": false, "error": "...", "message": "..."}

处理过程中引发的错误返回：

{"detail": "..."}

在列表请求中，失败的项在 results中携带自己的错误，并且请求的 HTTP 状态保持为 200。请参阅 批处理.

HTTP 状态代码

状态含义如何处理
400输入不可用：空文件、空白文本、不可读或密码保护的文档、格式错误的 job_details或重复的 JSON 键。对于录音任务，信用不足以预订 2 小时的最大值。修复有效载荷或添加信用。重试相同的字节将以相同的方式失败。
401“缺少 API 令牌…”、 “无效 API 令牌。”（未知或已吊销的密钥）、 “API 令牌已过期。” 或 “未知 API 端点”用于 /public/ 下不存在的路径。检查 Authorization 头部、密钥和路径。
403密钥有效，但账户无法提供服务：无预付信用（"... 在控制台中购买信用。\），账户被暂停，或"账户配置不完整"。在 控制台 → 计费中添加信用，或等待配置完成。如果账户被暂停，请联系我们。
404未知 job_id, 或由不同帐户注册的内容。同时，也可能是未知的任务 ID，或路径超出 /public/.重新注册作业；ID 范围限定于创建它们的凭证。检查基本的 URL。
413超过大小上限：请求体、文档、录音、批处理长度或字符数。分割工作负载，或通过链接发送录音。请参阅 请求大小限制。.
422模式验证失败：缺少必需字段或字段名称错误。同时，也可能是翻译语言不在 85 个支持的代码中。比较 OpenAPI 规范。字段名称区分大小写。请参阅 语言。.
429超出速率限制。退后并重试。如有 Retry-After ，请遵守。
500我们的故障。重试一次。如果仍然存在问题，请联系我们 X-Curriculo-Request-Id.
503依赖项不可用，或者某个功能在此处未启用（例如媒体转录）使用退避重试
504处理时间超过了300秒的限制发送较少的项或较小的文档，或者使用 异步通道.

[！NOTE] 失败的请求永远不会被收费。一个 4xx 或 5xx 不会花费任何费用，失败的后台任务也不会

重试指南

  • 不要重试 、400、401、403、404、413 或 422 的请求，而不进行任何修改。首先修复请求
  • 使用退避重试 ，在 429 和 503.
  • 重试一次 ，在 500.
  • 在 504， 重新发送，发送较少的项或较小的文档。在列表请求中，只重新提交返回 504 条目的项
  • 重新发送单个失败的文档始终是安全的。它不会创建重复或半完成的记录。

联系

写信给 [email protected] ，内容包括时间、操作和 X-Curriculo-Request-Id.

Updated