... 2026-2-4 大约 1 分钟
# Open API 返回码说明
腾讯文档开放平台 Open API 的错误返回会返回 2 级错误信息， 分别是：
1、 HTTP 请求 Header 里的 Status Code
2、 响应正文中的 Error 对象， 该对象包含可帮助用户确定错误原因和如何处理错误等其他详细信息。
# 通用错误码
通用错误码 对应 Error对象中的 code
| HTTP 状态码 | 通用错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 400 | 400001 | 请求参数错误 | 确认传入的参数是否合法 |
| 504 | 400002 | 服务端请求超时 | 服务端错误，请联系开发者 |
| 404 | 400003 | 访问的资源不存在 | 确认请求的资源是否被删除 |
| 409 | 400004 | 创建的资源已存在 | 确认传入的资源是否已经存在 |
| 403 | 400005 | 不允许访问该资源 | 确认是否拥有合法权限 |
| 401 | 400006 | 资源操作未授权 | 确认鉴权三元组是否合法有效 |
| 429 | 400007 | 请求数超过限制 | 请求数超过限频，请降低调用频率 |
| 400 | 400008 | 访问了超过范围的资源 | 确认操作的范围是否越界 |
| 503 | 400009 | 服务处于不可用状态 | 服务端错误，请联系开发者 |
| 500 | 400010 | 服务内部错误 | 服务端错误，请联系开发者 |
# 业务错误码
业务错误码 对应 Error对象中的 internalCode
查询更多业务返回码