错误码
当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。
|
状态码 |
错误码 |
错误信息 |
描述 |
处理措施 |
|---|---|---|---|---|
|
400 |
Versatile.03001001 |
Input parameter is invalid |
输入参数无效。 |
请检查输入参数是否正确。 |
|
400 |
Versatile.03002106 |
Operation failed |
外部知识库不支持文件下载。 |
第三方知识库连接不存在。 |
|
400 |
Versatile.03003039 |
Operation failed |
未找到图片或图片已过期。 |
请稍后重试。 |
|
403 |
Versatile.03001021 |
Operation failed |
下载的文件为空。 |
请检查并重试。 |
|
404 |
Versatile.03001003 |
resource not exist |
资源不存在。 |
请联系技术支持。 |
|
404 |
Versatile.03002010 |
Can not retrieve in knowledge base |
这些知识已被删除或关闭。 |
请检查这些知识的状态。 |
|
500 |
Versatile.03000000 |
System internal error |
系统内部错误。 |
请联系技术支持。 |
|
500 |
Versatile.03002019 |
Operation failed |
未找到该文件或该文件已过期。 |
请检查后再重试。 |
|
500 |
Versatile.03002104 |
Query third party knowledgeBases error |
第三方知识库连接信息错误。 |
请检查连接信息后重试。 |
|
200 |
Versatile.02101016 |
Insufficient execution permissions for Agent. |
当前用户无权在指定项目中运行该单智能体应用 |
请确认当前用户在目标项目中拥有该单智能体应用的执行权限 |
|
200 |
Versatile.100002 |
Parameter validation failed |
输入参数格式不正确或缺少必要参数 |
请检查请求参数是否符合接口规范 |
|
400 |
Versatile.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 |
Versatile.02001017 |
API call count for Agent exceeds quota. |
智能体API调用次数已用完。 |
请升级套餐。 |
|
403 |
Versatile.02201020 |
Insufficient workflow execution permissions. |
当前执行请求的projectId与工作流所属projectId不一致。 |
请确保当前空间中的projectId与工作流所属的projectId一致。 |
|
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等）是否正确。 |
|
404 |
Versatile.02101007 |
Agent does not exist. |
请求的智能体应用未找到或已被删除。 |
请确认该应用是否存在。 |
|
429 |
APIG.0308 |
The throttling threshold has been reached: policy user over ratelimit,limit:XX,time:1 minute. |
发送请求超过了服务的默认配置限流。 |
通过重试机制，在代码里检查返回值，碰到并发错误可以延时一小段时间（如2-5s）重试请求。 后端检查上一个请求结果，上一个请求返回之后再发送下一个请求，避免请求过于频繁。 |
|
500 |
Versatile.02201004 |
Workflow or workflow version does not exist. |
请求中指定的工作流ID在当前项目和工作区中不存在，可能已被删除或未正确创建。 |
请确认工作流ID是否正确，并确保该工作流在当前项目和工作区中已存在。 |
|
504 |
APIG.0201 |
Backend timeout. |
请求超时。 |
请检查原调用请求是否过于频繁，如果是并发过大，可以通过重试机制解决，在代码里检查返回值，碰到这个并发错误可以延时一小段时间（如2-5s）重试请求；也可以后端检查上一个请求结果，上一个请求返回之后再发送下一个请求，避免请求过于频繁。 |
