错误码
当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。
| 状态码 | 错误码 | 错误信息 | 描述 | 处理措施 |
|---|---|---|---|---|
| 400 | AgentArts.03001001 | Input parameter is invalid | 输入参数无效。 | 请检查输入参数是否正确。 |
| 400 | AgentArts.03002106 | Operation failed | 外部知识库不支持文件下载。 | 第三方知识库连接不存在。 |
| 400 | AgentArts.03003039 | Operation failed | 未找到图片或图片已过期。 | 请稍后重试。 |
| 403 | AgentArts.03001021 | Operation failed | 下载的文件为空。 | 请检查并重试。 |
| 404 | AgentArts.03001003 | resource not exist | 资源不存在。 | 请联系技术支持。 |
| 404 | AgentArts.03002010 | Can not retrieve in knowledge base | 这些知识已被删除或关闭。 | 请检查这些知识的状态。 |
| 500 | AgentArts.03000000 | System internal error | 系统内部错误。 | 请联系技术支持。 |
| 500 | AgentArts.03002019 | Operation failed | 未找到该文件或该文件已过期。 | 请检查后再重试。 |
| 500 | AgentArts.03002104 | Query third party knowledgeBases error | 第三方知识库连接信息错误。 | 请检查连接信息后重试。 |
| 400 | AgentArts.05001001 | StartTime can not bigger than EndTime or Time interval is too large. | 结束时间早于了开始时间或者时间间隔过大。 | 请确认入参的开始时间和晚于结束时间。 |
| 400 | AgentArts.05001003 | invalid Parameter:{0}. | 非法参数：{0}。 | 请检查请求参数是否符合接口规范。 |
| 400 | AgentArts.05030001 | not support sentence. | 不支持的查询语句。 | 请检查请求参数是否符合接口规范。 |
| 400 | AgentArts.05080007 | account has been frozen. | 账户被冻结。 | 申请解冻账户。 |
| 400 | AgentArts.05090001 | Non-beta user | 非公测用户 | 用户申请公测。 |
| 403 | AgentArts.05001007 | No permission. | 无权限。 | 请确认当前用户有权限执行该接口。 |
| 404 | AgentArts.05001005 | Resource {0} dose not exist. | 资源{0}不存在。 | 请检查请求参数是否符合接口规范。 |
| 500 | AgentArts.05000001 | Internal Server Error | 未知错误 | 系统错误，请稍后重试。 |
| 500 | AgentArts.05000002 | json handle error. | json处理错误。 | 请检查请求参数是否符合接口规范。 |
| 500 | AgentArts.05001010 | datasource init failed:{0}. | 数据库初始化失败:{0}。 | 初始化失败，请稍后重试。 |
| 500 | AgentArts.05080005 | subscribe ops error, step:{}. | 开通ops报错, 步骤:{}。 | 开通失败，请稍后重试。 |
| 500 | AgentArts.05080007 | no subscription. | 未订阅。 | 请确保用户已订阅。 |
| 400 | AgentArts.03400001 | 无效的请求 | 客户端发送的请求语法错误、必填参数缺失或身份鉴权凭证（Token）失效。 | |
| 400 | AgentArts.03400002 | 资源已经存在，导致错误 | 资源已经存在 | 检查资源是否存在 |
| 400 | AgentArts.03400003 | 没有权限访问，导致错误 | 没有权限访问资源 | 检查是否有权限访问 |
| 400 | AgentArts.03400004 | 超出数量限制，导致错误 | 超出资源数量限制 | 检查是否超出数量限制 |
| 404 | AgentArts.03404001 | 资源未找到 | 请求的资源不存在。可能是由于资源 ID 错误、资源已被物理删除或请求了不存在的 API 路径。 | |
| 500 | AgentArts.03500001 | 服务内部错误 | 服务器在处理请求时发生了未预期的异常，通常与后端逻辑故障、数据库连接超时或三方依赖服务异常有关。 | |
| 200 | AgentArts.02101016 | Insufficient execution permissions for Agent. | 当前用户无权在指定项目中运行该单智能体应用 | 请确认当前用户在目标项目中拥有该单智能体应用的执行权限 |
| 200 | AgentArts.100002 | Parameter validation failed | 输入参数格式不正确或缺少必要参数 | 请检查请求参数是否符合接口规范 |
| 400 | AgentArts.02101032 | Current Agent version does not exist | 请求中指定的Agent或其版本在系统中不存在，可能已被删除或未正确发布 | 请确认Agent ID和版本信息是否正确，并确保该Agent已成功发布并可用。 |
| 401 | APIG.0301 | Incorrect IAM authentication information. | IAM身份验证信息不正确： decrypt token fail：token解析失败。 token expires：token过期。 verify aksk signature fail：AK/SK认证失败。 x-auth-token not found：未找到x-auth-token参数。 | token解析失败，请检查获取token的方法，请求体信息是否填写正确，token是否正确；检查获取token的环境与调用的环境是否一致。 token超时（token expires） ，请重新获取token，使用不过期的token。 请检查AK/SK是否正确（AK对应的SK错误，不匹配；AK/SK中多填了空格）。 AK/SK频繁出现鉴权出错，连续错误5次以上，被锁定5分钟（5分钟内，则一直认为其是异常的鉴权请求），5分钟后解锁重新认证。 检查账号权限，是否欠费，被冻结等。 检查调用API时，请求header参数X-Auth-Token是否拼写正确。 |
| 401 | common.01010018 | Auth token failed | 不正确的token信息，token解密失败 | 请检查输入的x-auth-token是否正确 |
| 403 | AgentArts.02001017 | API call count for Agent exceeds quota. | 智能体API调用次数已用完。 | 请升级套餐。 |
| 404 | AgentArts.02101007 | Agent does not exist. | 请求的智能体应用未找到或已被删除。 | 请确认该应用是否存在。 |
| 404 | APIG.0101 | The API does not exist or has not been published in the environment. | 访问的API不存在或尚未在环境中发布。 | 请检查API的URL是否拼写正确，例如，URL中是否缺少project_id。 HTTP请求方法（POST，GET等）是否正确。 |
| 429 | APIG.0308 | The throttling threshold has been reached: policy user over ratelimit,limit:XX,time:1 minute. | 发送请求超过了服务的默认配置限流。 | 通过重试机制，在代码里检查返回值，碰到并发错误可以延时一小段时间（如2-5s）重试请求。 后端检查上一个请求结果，上一个请求返回之后再发送下一个请求，避免请求过于频繁。 |
| 500 | AgentArts.02201004 | Workflow or workflow version does not exist. | 请求中指定的工作流ID在当前项目和工作区中不存在，可能已被删除或未正确创建。 | 请确认工作流ID是否正确，并确保该工作流在当前项目和工作区中已存在。 |
| 504 | APIG.0201 | Backend timeout. | 请求超时。 | 请检查原调用请求是否过于频繁，如果是并发过大，可以通过重试机制解决，在代码里检查返回值，碰到这个并发错误可以延时一小段时间（如2-5s）重试请求；也可以后端检查上一个请求结果，上一个请求返回之后再发送下一个请求，避免请求过于频繁。 |
