本文介绍了调用内容检测API的公共返回参数和公共错误码。
公共返回参数
所有请求均返回JSON格式数据。下表描述了返回参数中的公共字段。
名称 | 类型 | 描述 |
Code | Integer | 错误码。
更多内容,请参见公共错误码。 |
Msg | String | 错误的详细描述。 |
RequestId | String | 唯一标识该请求的ID,可用于定位问题。 |
Data |
| API(业务)相关的返回数据。出错情况下,该字段可能为空。一般来说,该字段为一个JSON结构体或数组。 |
公共错误码
Code | Msg | 描述 |
200 | OK | 请求成功。 |
280 | PROCESSING | 任务正在执行中,建议您等待一段时间(例如5s)后再查询结果。 |
400 | BAD_REQUEST | 请求有误,通常由于请求参数不正确导致,请仔细检查请求参数。 |
401 | NOT_ALLOWED | 请求失败,通常是由于使用了不安全的图片、视频、语音链接地址。 |
403 | FORBIDDEN | 请求访问失败,通常由于您的图片、视频、语音链接无法访问导致,请确认公网是否可访问,并且无防盗链策略。 如果访问地址为阿里云OSS文件路径,需要先授权内容安全访问OSS存储空间。 |
404 | NOT_FOUND | 待检测内容未找到,通常是由于您的图片、视频、语音内容无法下载导致,请确认内容可通过公网访问到。 |
480 | DOWNLOAD_FAILED | 下载失败,请确认待检测内容的大小、分辨率(如果有)在API的限制范围内。 |
500 | GENERAL_ERROR | 一般是服务端临时出错。建议重试,若持续返回该错误码,请通过在线服务联系我们。 |
503 | ServiceUnavailable | 一般为系统异常。建议您检查请求域名是否正常,如确认域名正常请通过在线服务联系我们并提供对应案例。 |
580 | DB_FAILED | 数据库操作失败。建议重试,若持续返回该错误码,请通过在线服务联系我们。 |
581 | TIMEOUT | 超时。建议重试,若持续返回该错误码,请通过在线服务联系我们。 |
585 | CACHE_FAILED | 缓存出错。建议重试,若持续返回该错误码,请通过在线服务联系我们。 |
586 | ALGO_FAILED | 算法出错。请通过在线服务联系我们。 |
587 | MQ_FAILED | 中间件出错。请通过在线服务联系我们。 |
588 | EXCEED_QUOTA | 请求频率超出配额。默认配额:图片检测50张/秒,视频检测20路/秒,语音检测20路/秒,文本检测100条/秒,图片OCR 10张/秒。如果需要调整配额,请通过在线服务联系我们。 说明 关于价格说明,请参见内容安全产品定价。 |
589 | TOO_LARGE | 待检测内容过大,请确保检测的内容在API的限制范围内。建议重试,若持续返回该错误码,请通过在线服务联系我们。 |
590 | BAD_FORMAT | 待检测内容格式错误,请确保检测的内容在API的限制范围内。 |
591 | CONNECTION_POOL_FULL | 连接池满。请通过在线服务联系我们。 |
592 | DOWNLOAD_TIMEOUT | 下载超时,下载时间限制为3秒,请确保检测的内容大小在API的限制范围内。 |
594 | EXPIRED | 任务过期,如TaskId过期。 |
595 | CATCH_FRAME_FAILED | 截帧失败,请通过在线服务联系我们。 |
596 | PERMISSION_DENY | 账号未授权、账号欠费、账号未开通、账号被禁等原因,具体可以参考返回的错误描述。 |