ROLL API DOCS

接口错误码说明

这里汇总所有公开 API 可能返回的业务错误码。接口请求失败时，可根据返回体中的 code 和 msg 快速定位原因。

224
个错误码
返回格式
正常响应一般为 code = 1；业务失败会返回对应错误码和错误描述，部分错误描述中可能包含接口名、账号、参数等动态信息。

通用错误

所有接口可能返回的认证、限流、分页、文件与公共资源错误。

16 项
错误码常量名说明
110COMMON_REQUEST_ERR请求受限
103COMMON_REQUEST_ERR2请求受限
104COMMON_REQUEST_ERR7请求受限
101COMMON_REQUEST_ERR4请求频率过快，超过当前账号 QPS 的限制
101COMMON_REQUEST_ERR8请求频率过快，超过 FREEAPI 共享账号 QPS 的限制
102COMMON_REQUEST_ERR5请求次数超限，FREEAPI 共享账号今日次数已用完
102COMMON_REQUEST_ERR6请求次数超限，超过当前账号每日访问次数限制
20003COMMON_REQUEST_ERR3当前账号检测到违规操作，已被冻结，详情请联系管理员
20004COMMON_APPID_ERRORapp_id 或 app_secret 不合法
20005COMMON_APPID_UNSUPPORT非 app_id 请求方式已停止对外服务
20006COMMON_MAX_PAGE最多只能获取最近 50 页数据
20007COMMON_MAX_LIMIT每页数据最多只能为 10 条
20008COMMON_MAX_PAGE_STORY最多只能获取最近 20 页数据
20009COMMON_COS_IMAGE_ERR当前账号图片相关接口剩余访问次数不足
20001COMMON_FILE_SAVE_ERROR文件存储失败
20002COMMON_BASE64_DECODE_ERRORBASE64 解析失败

IP 与地理位置

IP 查询、手机号归属地、ICP/域名等基础数据接口错误。

11 项
错误码常量名说明
10001IP_REQUEST_ERRORIP 获取失败
10002IP_OBTAIN_ERRORIP 地址获取失败
10003IP_FORMAT_ERRORIP 不合法
1010003IP_FORMAT_ERROR1暂不支持 IPv6 查询
10062MOBILE_LOCATION_ERROR手机号格式不正确
10063MOBILE_LOCATION_ERROR1未查询到相关数据
10064MOBILE_LOCATION_ERROR2请输入物品名称
10082DOMAIN_ERRORdomain 不能为空
10083DOMAIN_ERROR1未备案或已取消备案
110083DOMAIN_ERROR2会员等级为铂金会员或者钻石会员才可使用实时查询
1110083DOMAIN_ERROR3未查询到数据

日期、节假日与基础工具

节假日、计算器、翻译、验证码、每日一句、配置中心等接口错误。

31 项
错误码常量名说明
10004HOLIDAY_ERROR1日期不能为空
10005HOLIDAY_ERROR2日期格式错误(yyyyMMdd)
10006HOLIDAY_ERROR3未找到对应数据
10007HOLIDAY_ERROR4格式错误(yyyyMMdd,yyyyMMdd...)
10008HOLIDAY_ERROR5日期格式错误(yyyyMM)
10009HOLIDAY_ERROR6日期格式错误(yyyy)
10010HOLIDAY_ERROR7没有对应日期的节假日信息，请联系管理员
10011HOLIDAY_ERROR8类型传入错误
10065CALCULATOR_ERROR表达式无法解析
10066CALCULATOR_ERROR1结果计算失败
10069CONVERT_ERRORtype 只能是 1 或 2
10070CONVERT_ERROR1内容不能为空
10071CONVERT_ERROR2请输入单个汉字
10072CONVERT_ERROR3翻译的目标语言不能为空
10073CONVERT_ERROR4翻译失败，请稍后重试
10074CONVERT_ERROR5翻译接口因版权已停止服务
10075VERIFY_ERROR验证码生成失败
10076DAILY_WORD_ERRORcount 范围 [1~20]
10047CONFIG_ERROR1config 不能为空
10048CONFIG_ERROR2secret 不能为空
100048CONFIG_ERROR12sign 不能为空
100049CONFIG_ERROR13sign 不合法
10049CONFIG_ERROR3user_id 不能为空
10050CONFIG_ERROR4type 值错误
10051CONFIG_ERROR5name 不能为空
10052CONFIG_ERROR6desc 不能为空
10053CONFIG_ERROR7user_id 不合法
10054CONFIG_ERROR8未找到对应的配置信息
10055CONFIG_ERROR9secret 参数不合法
10056CONFIG_ERROR10已有同名同应用类型的应用存在
10057CONFIG_ERROR11项目创建失败

二维码、短链、条码与资源包

二维码生成、短链、商品条码、请求代理、ROLL API 设置等接口错误。

30 项
错误码常量名说明
10012QRCODE_ERROR1内容不能为空
10013QRCODE_ERROR2大小不能小于 10
10014QRCODE_ERROR3type 只能为 0 或者 1
10015QRCODE_ERROR4logo 大小不能小于 10
10016QRCODE_ERROR5logo 大小不能大于二维码本身大小
10017QRCODE_ERROR6logo 图片不能为空，仅支持 jpg 和 png
10018QRCODE_ERROR7type 只能为 0 或者 1
10019QRCODE_ERROR8logo 上传失败
10020QRCODE_ERROR9二维码生成失败，logo 仅支持 jpg 和 png
10077SHORT_LINK_ERROR原链接不能为空
10078SHORT_LINK_ERROR1短链生成失败，请稍后再试
10079SHORT_LINK_ERROR2当前短链所属账号短链访问次数已用尽
10080SHORT_LINK_ERROR3此短链无效
10032BARCODE_ERROR1内容不能为空
10033BARCODE_ERROR2宽不能小于 50
10034BARCODE_ERROR3高不能小于 20
10035BARCODE_ERROR4type 只能为 0 或者 1
10036BARCODE_ERROR5暂未收录此商品
10037BARCODE_ERROR6添加成功
10038BARCODE_ERROR7商品名称不能为空
10039BARCODE_ERROR8条码不能为空
10040BARCODE_ERROR9商品价格不能为空
10041BARCODE_ERROR10条形码生成失败，请检查内容
100041BARCODE_ERROR11条形码格式不支持
10162REQUEST_PROXY_ERRORconfig 不能为空
10163REQUEST_PROXY_ERROR1method 不能为空
10164REQUEST_PROXY_ERROR2请求 url 不能为空
10165REQUEST_PROXY_ERROR3暂时仅支持 GET 和 POST 请求
10167ROLL_API_SETTING创建子秘钥失败
10168ROLL_API_SETTING1子秘钥不存在

天气、新闻、生活数据

天气、新闻、垃圾分类、历史上的今天、成语、歇后语、菜谱等接口错误。

40 项
错误码常量名说明
10042WEATHER_ERROR1城市名不能为空
10043WEATHER_ERROR2未找到对应城市，请检查后重试
10044WEATHER_ERROR3今日天气获取失败
10045WEATHER_ERROR4未来天气获取失败
10046WEATHER_ERROR5未找到指定城市的天气信息，请修改后重试
10058NEWS_ERROR1newsId 内容不合法
10059NEWS_ERROR2typeId 异常
10060NEWS_ERROR3数据获取失败
10061NEWS_ERROR4新闻详情已失效或不存在
10067RUBBISH_ERROR未查询到相关数据，可试着查询垃圾材质
10068HISTORY_TODAY_ERRORtype 只能是 0 或 1
10092IDCARD_ERROR未查询到相关数据
10093DRIVER_EXAM_ERRORrank 类型异常
10094DRIVER_EXAM_ERROR1请传入有效 id 列表
100094DRIVER_EXAM_ERROR3subjectType 值异常
10095FOOD_ERROR食物 id 不能为空
10096FOOD_ERROR1关键字不能为空
10097FOOD_ERROR2id 不存在
100098FOOD_ERROR3食物 id 列表不能为空
100099FOOD_ERROR4id 列表最大长度超过默认分页大小，超过部分将被忽略
10098IDIOM_ERROR关键字不能为空
10099IDIOM_ERROR1数据异常
10100IDIOM_ERROR2关键字至少长度至少为 2
10113IDIOM_ERROR3只能输入一个文字
10101XIEHOUYU_ERROR关键字不能为空
10102XIEHOUYU_ERROR1数据异常
10103XIEHOUYU_ERROR2关键字至少长度至少为 2
10104COOKBOOK_ERROR1关键字不能为空
10105COOKBOOK_ERROR2id 不能为空
10106COOKBOOK_ERROR3内容不能为空
10107COOKBOOK_ERROR4昵称不能为空
10108COOKBOOK_ERROR5菜谱不存在或被删除
10109COOKBOOK_ERROR6分类不存在
10110COOKBOOK_ERROR7请使用三级分类进行查询
10111COOKBOOK_ERROR8评论内容长度最多 255 字符
10112COOKBOOK_ERROR9评论失败
100112COOKBOOK_ERROR10请传入需要删除的评论 id 列表，用英文逗号分割
10114STORY_ERROR1类型不存在
10115STORY_ERROR2内容不存在
100115STORY_ERROR3请输入关键字

彩票与油价

彩票、油价等数据接口错误。

14 项
错误码常量名说明
10021LOTTERY_ERROR1该接口已经停用，请替换到新版本接口【/common/aim_lottery】
10022LOTTERY_ERROR2该接口已经停用，请替换到新版本接口【/common/history】
10023LOTTERY_ERROR3该接口已经停用，请替换到新版本接口【/common/latest】
10024LOTTERY_ERROR4code 值不合法
10025LOTTERY_ERROR5最多只能获取最近 50 期数据
10026LOTTERY_ERROR6size 值不合法
10027LOTTERY_ERROR7未找到对应数据
10028LOTTERY_ERROR8暂不支持此彩种
10029LOTTERY_ERROR9被检测号码中有两个及以上个 @
10030LOTTERY_ERROR10未找到与指定关键字相关的数据
10081OIL_ERROR1省份不能为空
10081OIL_ERROR2省份信息不合法
10081OIL_ERROR3没找到相关数据
10031JOKES_ERROR1此接口仅支持获取前 50 页数据

视频与媒体解析

哔哩哔哩、抖音、快手、小红书、随机视频等媒体类接口错误。

28 项
错误码常量名说明
10084BILIBILI_ERROR链接格式有误
10085BILIBILI_ERROR1解析失败-1002
10085BILIBILI_ERROR5解析失败-1001
100085BILIBILI_ERROR2解析失败
100086BILIBILI_ERROR3参数不合法，bvid、aid 和 cid 必传
1100086BILIBILI_ERROR4当前账号剩余访问次数不足
10087DOUYIN_ERROR1视频已被删除或不存在
10088DOUYIN_ERROR2视频解析失败
10089DOUYIN_ERROR3url 格式有误
10090DOUYIN_ERROR4user_agent 格式有误
110091DOUYIN_ERROR5当前账号剩余访问次数不足
10134KUAISHOU_ERROR1视频已被删除或不存在
10135KUAISHOU_ERROR2视频解析失败
10136KUAISHOU_ERROR3url 格式有误
100136KUAISHOU_ERROR4cookie 格式有误
100137KUAISHOU_ERROR5当前账号剩余 ROLL 币不足
10137XHS_ERROR1数据获取失败
10138XHS_ERROR2url 格式有误
100138XHS_ERROR3数据获取失败
100139XHS_ERROR4视频解析失败，错误原因为指定内容
100140XHS_ERROR5数据获取失败，数据不存在或被删除
100141XHS_ERROR6userId 不能为空
100142XHS_ERROR7搜索关键字不能为空
100143XHS_ERROR8cookie 不合法或已过期
100144XHS_ERROR9参数格式不正确
10145RANDOM_VIDEO_ERROR内容获取失败
10146RANDOM_VIDEO_ERROR1内容获取失败
10147RANDOM_VIDEO_ERROR2内容获取失败

抖音 Pro

抖音 Pro 解析、评论、用户、作品、合集、文案提取等接口错误。

25 项
错误码常量名说明
10139DOUYIN_PRO_ERRORurl 格式有误
10140DOUYIN_PRO_ERROR2视频解析失败
1010140DOUYIN_PRO_ERROR22评论获取失败
10141DOUYIN_PRO_ERROR3当前账号剩余访问次数不足
10142DOUYIN_PRO_ERROR4用户信息获取失败
10143DOUYIN_PRO_ERROR5用户发布的作品获取失败
10144DOUYIN_PRO_ERROR6内容不能为空
101444DOUYIN_PRO_ERROR60类型异常
100145DOUYIN_PRO_ERROR7用户 shareText 不能为空
100146DOUYIN_PRO_ERROR8count 最多只能 100
100147DOUYIN_PRO_ERROR9文案提取异常
100148DOUYIN_PRO_ERROR10day 只能是 7 或者 30
100149DOUYIN_PRO_ERROR11数据获取失败
100150DOUYIN_PRO_ERROR12当前账号活跃度太低，未被抖音官方收录
100151DOUYIN_PRO_ERROR13请输入关键字
100152DOUYIN_PRO_ERROR14数据获取失败
100153DOUYIN_PRO_ERROR15数据获取失败
100154DOUYIN_PRO_ERROR16用户 shareText 或 userId 至少输入一个
100155DOUYIN_PRO_ERROR17数据不存在
100156DOUYIN_PRO_ERROR18用户 userInfo 不能为空
100157DOUYIN_PRO_ERROR19count 只能为 10、20、30、40 或者 50
100158DOUYIN_PRO_ERROR20mixId 不能为空
100159DOUYIN_PRO_ERROR21count 只能为 10
100160DOUYIN_PRO_ERROR23seriesId 不能为空
100161DOUYIN_PRO_ERROR24请先在管理后台配置阿里云百炼的 API_KEY

用户、AI 与通知

云用户、AI、微信通知/群通知等接口错误。

29 项
错误码常量名说明
10116CLOUD_USER_ERROR1手机号不能为空
10117CLOUD_USER_ERROR2验证码不能为空
10118CLOUD_USER_ERROR3昵称不能为空
10119CLOUD_USER_ERROR4密码不能为空
10120CLOUD_USER_ERROR5配置不能为空
10121CLOUD_USER_ERROR6当前账号验证码次数已用尽
10122CLOUD_USER_ERROR7用户已存在，请直接登录
10123CLOUD_USER_ERROR8附加参数长度最大 255
10124CLOUD_USER_ERROR9注册失败，请稍后再试
10125CLOUD_USER_ERROR10账号或者密码错误
10126CLOUD_USER_ERROR11验证码不正确
10127CLOUD_USER_ERROR12当前账号不存在，请先注册
10128CLOUD_USER_ERROR13用户登录过期
10129CLOUD_USER_ERROR14没有找到对应配置信息
10130CLOUD_USER_ERROR15类型仅支持注册验证码、修改密码验证码、验证码登录发送验证码
10131CLOUD_USER_ERROR16配置 key 不能为空
10148AI_ERROR请输入内容
10149AI_ERROR1type 为 0 文本返回，1 流式分段返回
10150AI_ERROR2图片链接不能为空
10151AI_ERROR3BETA 验证阶段每日发放 10 次访问次数，当前次数不足
10152AI_ERROR4数据获取失败，请联系客服
10169WXNOTICE_API_ERROR内容不能为空
10170WXNOTICE_API_ERROR1内容长度不能超过 1000 个字符
10171WXNOTICE_API_ERROR2微信/群 id 不能为空
100172WXNOTICE_API_ERROR3发送的图片不存在
100173WXNOTICE_API_ERROR4当前群 ID 您未配置，请前往配置后再使用
100174WXNOTICE_API_ERROR5获取失败，请联系客服
100175WXNOTICE_API_ERROR6群 id 格式不正确
100176WXNOTICE_API_ERROR7at 用户 id 和 at 昵称必须同时填写或同时不填写