错误码
当您调用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 | 第三方知识库连接信息错误。 | 请检查连接信息后重试。 |
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调用次数已用完。 | 请升级套餐。 |
403 | AgentArts.02201020 | Insufficient workflow execution permissions. | 当前执行请求的projectId与工作流所属projectId不一致。 | 请确保当前空间中的projectId与工作流所属的projectId一致。 |
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）重试请求；也可以后端检查上一个请求结果，上一个请求返回之后再发送下一个请求，避免请求过于频繁。 |
