全局返回码说明

全局返回码说明

调用开放平台 HTTP API 接口时，可能获得正确或错误的返回码，开发者可以根据返回码信息调试接口，排查错误。

错误码错误码描述场景描述
0操作成功
OP1001操作失败
OP1002参数缺失，请确认参数是否有缺失请求体中，有必填项在 params 中不存在
OP1003参数取值不合法(参数格式有误或为空)，请修正参数值1.请求体中，有必填项为空（""或 null）；2.有传参与协议规定的参数类型不符；3.有传参格式不符合合法值描述
OP1004请求内容为空请求内容为空
OP1005无效的请求 URL请求的接口 URL 不存在，请检查接口 URL 是否正确
OP1006SDK 异常1.SDK 调用时，请求体中 head 为空；2.head 中有字段缺失；3.head 中有字段为空
OP1007无效的方法调用1.外部接口调用时，system.appId 为空（""或 null）；2.非用户模块接口调用时，params.token 不存在或 params.token 为空（""或 null）
OP1008appId 为空system.appId 值错误，请检查
OP1009权限不足，无法执行此操作开发者没有设备的相关权限
OP1010应用被冻结当前 App 状态为冻结中
OP1011当天调用接口次数已达上限API 调用接口已达限上限，请提交工单咨询联系
OP1012调用接口权限不足调用接口权限不足
OP1013调用接口次数超出限制(总数)接口总调用次数已达上限，请提交工单咨询联系
OP1014调用接口次数超出限制（每天）部分指定接口有调用次数限制，如果开发者调用对应接口超过次数限制，会返回此错误码
OP1015权限不足，无法执行此操作。(该设备不是开放平台绑定设备)权限不足，无法执行此操作。(该设备不是开放平台绑定设备)
OP1016请求的设备相关接口达到限制。开发者每周可操作的设备通道数不能超过当前开发者购买的设备接入数
OP1019此时间段无录像产生此时间段无录像产生
OP1021获取播放地址失败获取播放地址失败
OP1022直播前请先开启云解码功能请先在 乐橙 App--设置--账户与安全 中，打开“服务授权”开关，之后使用云直播功能
OP1023kitToken 已过期，请重新获取kitToken 已过期，请重新获取
OP1025当前IP请求频率过高，请稍后再试。
OP1026请求太频繁，请稍候再试。同一用户同时请求同一个获取 token 相关接口时，极少数情况下会出现此错误码
OP1029设备数量超出限制，请检查参数。
OP1030文件大小超出限制。
OP1031音视频文件时间超出限制。
OP1032文件不存在。
OP1033文件已存在。
OP1034不支持的音视频格式。
OP1035文件使用中，请稍后重试。
OP1039调用接口频率超出限制（分钟）未付费用户的请求接口频率上限为 20 次/分钟，付费用户为 500 次/分钟，超出即会报错；如业务扩展需提升频率上限，请提交工单或商务咨询。
OP1040当日调用接口总次数超出限制，请升级企业套餐或工单申请解除。未付费用户的每日请求接口总数上限为 10000 次，付费用户为 250000 次，超出即会报错；如业务扩展需提升接口上限，请提交工单或商务咨询。
OP1041查询开始及结束时间参数超出范围，请修改参数值
OP1043国标设备仅支持连续云存储国标设备当前仅支持开通连续云存储套餐。开通事件云存储时会报该错误码。请检查所选套餐是否正确
OP1044国标设备未连接云平台部分请求需要国标设备正常上线接入云平台才能正常下发，请将设备正常上线后重新操作
OP1045录像计划时长不能超出连续云存储套餐可用时长，请调整计划如果使用的是指定每日存储时长的连续云存储（例如 12 小时连续云存储套餐），设置的云录像计划总生效时长不能超过套餐支持的时长
OP1046设备上没有该云存储套餐请求中的云存储套餐 ID 不属于该设备，或套餐 ID 不存在，会报该错误码。请检查设备和套餐 ID 是否对应
OP1047余额不足开发者账号可用余额不足，请检查后重试
OP1048抽帧抓图计划不存在
OP1049录像解密失败，请检查输入秘钥。
OP1050该设备通道存在进行中的录像转录任务，请等结束后再创建新任务。
OP2002订单提交失败。
OP2017余额不足开发者账号可用余额不足，请检查后重试
OP2022未开通托管权限。
OP2047您现在无法进行该操作，如有疑问请添加企业微信联系。
OP2060抱歉，每分钟最大请求20次，请稍后再试
OP2061检测目标物图片需有蒙版，请重新上传
OP2062音频文件采样率需为16000Hz，请重新上传
SN1001签名异常请求体中，system.sign 的值计算异常，与平台计算的签名不一致，请检查计算规则
SN1002签名超时请求体中，system.time 的取值与请求当时的时间戳要求不能偏差超过 5min，请检查后重试
SN1003签名参数错误请求体中，system.time 不是数值（含字母或特殊字符）
SN1004非法的 appid非法的 appId
SN1005重复的 nonce重复的 nonce。开发者向开放平台调用接口时传入的 nonce 在 5 分钟内不能重复，否则会返回此错误码
TK1001该账户（phone）对应的用户与您的应用已绑定
TK1002token 已过期或不存在，请重新获取 tokentoken 已过期或不存在，请重新获取 token
TK1003非法 token，请传入正确的 token请检查 token 和 appId 是否对应。如果多个 appId 账号的 token 异常混用，会返回该错误码
TK1004当前用户的手机号码还未跟您的应用绑定请先进行“用户绑定”先进行用户绑定的操作
TK1005绑定用户数量超出限制非发布状态的 app 绑定用户数量超出限制
TK1006当前手机号码不是开发者账号的手机号码，开发者创建应用后，在开放平台网站>开发中心>应用详情页中可以找到管理员账号一项。
TK1007还未得到当前用户的授权，请先进行“用户授权绑定”操作。
TK2001失效的 csrfToken
FL1001开发者剩余接入数不足开发者新增设备接入，会消耗接入额度。当接入额度不足时，无法新绑定设备。可以通过开放平台网站-控制台-我的资源 查看设备接入额度是否超限
FL1002开发者当前无可用带宽播放设备视频时（实时预览、录像回放），需要消耗带宽或流量。当开发者无剩余流量，并且也未购买带宽，则返回错误信息。可以通过开放平台网站-控制台-我的资源 查看剩余流量和带宽额度
FL1003开发者当前使用带宽超过额度限制播放设备视频时（实时预览、录像回放），需要消耗带宽或流量。当开发者的带宽使用超过限额，则返回错误信息。可以通过开放平台网站-控制台-我的资源 查看带宽额度信息
FL1004开发者剩余流量不足播放设备视频时（实时预览、录像回放），需要消耗带宽或流量。当开发者无剩余流量，并且也未购买带宽，则返回错误信息。可以通过开放平台网站-控制台-我的资源 查看剩余流量信息
FL1005开发者音视频取流操作时没有可用带宽且剩余流量不足播放设备视频时（实时预览、录像回放），需要消耗带宽或流量。当开发者无剩余流量，并且也未购买带宽，则返回错误信息。可以通过开放平台网站-控制台-我的资源 查看剩余流量和带宽额度
FL1006已达到个人版套餐3路并发上限，请升级企业套餐
FL1008子账号流量使用达到上限。
FL1009设备通道流量使用达到上限。
DV1001设备已被其他账号绑定
DV1002设备不存在
DV1003设备已被当前账号绑定
DV1004更新通道名称失败
DV1005设备验证码错误
DV1006无需更新设备，设备已是最新版本
DV1007设备离线
DV1008绑定设备数量超出限制，请先解绑其他冗余设备非发布状态的 app 绑定设备数量超出限制。
DV1009设备正忙，请稍后再试需要操作的设备正在处理前一请求
DV1010抓图请求过于频繁，请稍后再试抓图接口调用过于频繁，1s 内同一设备抓图请求多次
DV1011设备未添加，请先绑定设备需要操作的设备并未被当前账号添加
DV1012权限不足，该设备属于被授权（或被共享）设备
DV1013设备注册 3 天后绑定,客户端与设备必须在同一个局域网内，设备断电重启下即可再次绑定。
DV1014设备绑定错误一分钟超过 20 次，限制绑定 30 分钟
DV1015设备绑定错误一小时超过 60 次，限制绑定 24 小时
DV1016设备密码错误。
DV1018设备注册到平台，超过三天未绑定，需在局域网内绑定，或重启设备后进行绑定设备注册到平台后，超过三天未绑定
DV1019设备能力集不支持此操作
DV1020设备通道离线。
DV1021设备异常。
DV1022收藏点个数超出限制
DV1023收藏点已存在
DV1024收藏点不存在
DV1025设备 SC 码或设备密码错误
DV1026该设备不支持此功能的调用
DV1027设备安全码错误
DV1028用户未绑定该设备或设备通道号不存在
DV1029设备已经被绑定
DV1030设备休眠中
DV1031低电量拒绝升级(带电池设备)
DV1032设备已被本人锁定
DV1033设备已被他人绑定
DV1034设备未初始化
DV1035设备初始化失败
DV1036注销失败，设备未离线达 5 分钟
DV1037NB 设备的 imei 和 device id 不匹配
DV1038低电量时无法添加临时秘钥
DV1039临时密钥生成不满足条件
DV1040设备已被绑定失败 20 次 限制绑定 24 小时
DV1041转移设备数量超过设定的最大值
DV1042设备密码错误达限制次数，设备锁定
DV1043项目属性不支持
DV1044设备 IP 不在同一局域网内
DV1045设备冲突
DV1047设备已经自定义加密
DV1049设备无存储介质
DV1050临时秘钥生成次数超限制
DV1051人脸库不存在
DV1052添加超过人脸库的上限
DV1053抓图失败，请检查网络调用手动抓图接口时，设备由于网络原因等没有及时返回图片。
DV1054新密码组成不符合规则，请按接口详情中密码规则进行修改
DV1055设备未通过开放平台绑定
DV1056此设备通道号已经分享给开发者，无需再次分享给开发者
DV1057通道不存在
DV1058您的账号为行业超级管理员账号，并且目前存在分享的设备，故无法解绑此设备
DV1059设备在 ONENET 平台已存在（被第三方绑定）
DV1060设备存储介质异常
DV1061设备响应超时，请检查设备网络
DV1062设备无心跳保持，需要在设备侧进行唤醒操作
DV1063设备铃声使用中，不能删除
DV1064iot 设备绑定随机码错误
DV1065不支持手动添加子设备在添加 Iot 设备的时候，如果是子设备（配件）的时候不支持直接通过接口添加
DV1066设备升级中，不支持此时操作设备升级中不支持其他操作
DV1067不支持 P2P 设备添加
DV1068拒绝访问wifi 异常，不支持访问
DV1069不满足操作条件
DV1070正在被接听
DV1071铃声名字冲突
DV1072该铃铛已经被关联。
DV1073该铃铛与门铃没有任何关联关系。
DV1074铃声无法删除。
DV1075SD卡寿命已尽。
DV1076SD卡加密，且未认证解密。
DV1077SD卡盘检中。
DV1078存储介质异常,需要初始化。
DV1079SD卡格式不支持。
DV1080补光中,不支持白光灯警戒
DV1081语音对讲中,不支持开启警笛
DV1082SD卡分区错误。
DV1088不支持使用该厂商的设备
DV1091账号不支持添加该设备
DV1092账号不支持添加该型号设备
DV1096设备升级中，请稍后重试。
DV1100NVR设备未绑定或已被他人绑定。
DV1101NVR序列号异常，请检查是否正确。
DV1102NVR设备离线。
DV1103IPC未与NVR关联，请先在NVR本地操作关联。
WF1001请求超时连接 wifi 超时
WF1002wifi 密码错误连接 wifi 时，请求体中 params.password 有误
SM1001验证码输入错误1.绑定用户时，params.smsCode 填写有误；2.绑定用户时，验证码以过期。
SM1002验证码已过期，请重新获取验证码
SM1003服务器处理错误
SM1004发送验证码短信失败
SM1005当天获取短信验证码次数已达上限1.非发布状态的 app 绑定用户时，获取短信验证码次数超出限制；2.发布状态的 app 绑定用户时，获取短信验证码次数超出限制；
SM1006短信发送过于频繁，请稍后再试获取短信接口调用过于频繁
SMS01短信发送次数超出限制
SMS02短信发送次数超出限制
TH1001当前方法有误，不是透传接口方法
TH1002安全码有误，请核对安全码是否与门户网站所填写“安全码”一致。
TH1003消息回调 URL 格式有误
ST1001当前设备默认云存储套餐已到期，操作失败开启默认云存储套餐时，默认套餐已过期
ST1002当前设备无默认云存储套餐，操作失败
ST1003当前使用的云存储套餐不是默认云存储套餐，操作失败
ST1004云存储套餐未开通
ST1005云存储套餐已过期
ST1006云存储套餐不存在
ST1007调用开通云存储接口次数不足一次
ST1008当前设备使用的定时录像计划用云存储套餐使用中，需暂停
ST1009操作失败，当前设备仍有未过期的收费云存储套餐策略。
ST1010该设备不支持对应云存储套餐策略
ST1011调用接口次数超过限制，同一个套餐 24 小时内只能解绑一次
ST1012免费云存储不支持解绑
ST1013云存储重复开通。
ST1014该设备不支持录像云存储功能。
ST1015过期的云存储套餐无法解绑。
ST1016云存储额度不足
ST1017使用4G无限流量的设备无法开通云存储
ST1018AI检索功能需启用智见云存储或AI智见套餐，请检查设备套餐信息
RC1001云录像未找到根据云录像片段信息查询云录像不存在
RC1002录像上传中，请稍后。
RC1004配置计划超过上限限制
LV1001该视频直播已存在绑定直播地址接口调用时，当前设备、rtsp 地址源已有直播地址绑定
LV1002该视频直播不存在
LV1004设备已经自定义加密密钥开启直播计划时，流量不足
LV1005直播信息不存在。
LV1006操作失败，同一 rtsp 源地址同一天内仅能被绑定 1 次。
LV1020已绑定直播,无法删除
LV1040该直播无权限操作。
LV1041无权限操作此设备。
LV1055设备4G套餐类型不符合，请使用开放平台4G套餐或联系官方客服
YL1001定时拉取模式下，拉取的时间点不能在定时录像计划时间内。
YL1002定时计划时间参数重合，重合时间为 XX-XX。
YL1003操作失败，存在有效的云存储录像计划，请关闭云存储录像计划后重试。
YL1004操作失败，存在有效的动检计划，请关闭动检计划后重试。
YL1005操作失败，请开通支持设置云存储录像计划的云存储策略套餐。云存储录像计划只支持连续云存储套餐操作，不支持事件云存储
GT1001授权角色已经存在
GT1002添加角色失败
GT1003用户授权已经存在
GT1004创建用户授权失败
GT1005用户授权不存在
GT1006角色不存在
GT1007角色为默认角色
GT1008授权超过限制
GT1009不能授权给自己
GT1010获取授权列表失败
GT1011获取权限列表所传参数有误
US1001用户不存在
US1002该用户不存在这个授权关系
US1003订单与用户校验未通过。
P2P001P2P 鉴权接口，鉴权 ID 已过期
P2P002P2P 鉴权接口，头部域参数缺失
P2P003token 过期
P2P004没有设备权限
AD1001未绑定综治员
LD1001设备本地无存储介质
AP1001配件不存在
AP1002配件离线
PF1001repositoryToken 不存在
PF1002faceToken 不存在
PF1003未检测到人脸
PF1004暂不支持该功能
PF1005图片大小超过 2M 限制
PF1006type 类型不匹配
PF1007获取特征值失败，请先进行图片检测
PF6008人脸库token错误
PF6009人脸库中没有这个成员
PF6010未检测到目标，请修改后重试
PF6011该人脸信息已在当前人脸库中注册
PF6012输入图片错误
PF6013人脸库创建达到上限
PF6014人脸库搜索未找到超过阈值的相似人脸
PF6015图片下载失败（检查图片地址）
PF6016图片解码失败
PF6017参数错误
PF6018检测到多个人脸目标，请保留一个人脸后重新请求
PF6019人脸过近，请修改后重试
PF6020人脸过远，请修改后重试
PF6021人脸角度错误，请使用正面人脸
PF6022人脸图片质量过低，请修改后重试
PF6023人脸图片异常，请重试或联系技术支持
PF6024人脸检测失败，请重试或联系技术支持
PF6025人脸比对失败，请重试或联系技术支持
PF6026图片检测失败，请重试或联系技术支持
PF6027图片解码失败，请更换或联系技术支持
PF6028图片尺寸超限，要求宽高为4096*3840以内，请修改后重试
PF6029图片下载失败，请重试或联系技术支持
PF6030人脸库名称已存在，请修改
PF6031检测目标key不存在
PF6032检测目标库不存在
PF6033检测目标数量已达到上限
PF6034算法未配置检测策略
PF6035文件大小过小
PF6036不支持的图片格式
PF6037图片宽度过小
PF6038图片宽度过大
PF6039图片高度过小
PF6040图片高度过大
PF7001视频检测任务已存在
PF7002检测任务不存在
PF7003检测任务未完成
PF7004设备已开启隐私模式，请关闭后重试
PF7005设备云解码关闭，请开启后重试
PF7006检测任务失败，请重试或联系技术支持
UR1000用户未登陆
UR1001不支持邮箱登陆
PH1001修改手机号频次已达上限
SUB1000子账号无法进行此操作
SUB1001当前子账号无指定权限，无法操作
SUB1002子账号无设备任意权限，无法操作
SUB1005子账号 token 过期
SUB1006子账号与设备无授权关系
SUB1007创建子账号失败
SUB1008子账号与当前应用无绑定关系
SUB1009子账号创建失败，账号格式错误仅支持手机号或者邮箱作为子账号
SUB1010子账号创建失败，账号已存在重复绑定子账号到应用下
AI1004AI智见套餐信息错误，请检查套餐ID
AI1006要操作的AI智见套餐不存在，请检查输入的套餐信息
AI1007该套餐剩余可用额度不足，请购买套餐
AI1010多目设备需使用专属多目AI套餐，请修改输入的套餐信息
AI1011国标设备暂不支持开通AI智见套餐
AU1001授权已失效，无法操作。
AU1002存在已授权设备，请重试。
AU1003授权开发者拥有设备权限，无法授权。
AU1004授权对象不存在，请确认路径是否正确。
AU1005授权内容不存在，请确认参数。
AU1006授权用户已存在。
GB1001设备或通道国标ID已存在
GB1002通道ID已存在
GB1003通道国标ID已存在
GB1004关联NVR设备国标ID不存在
GB1005设备国标ID格式错误
GB1006通道国标ID格式错误
GB1007通道ID重复
GB1008通道国标ID重复
GB1009国标项目不存在
GB1010导入数据通道ID重复
GB1011导入数据国标ID重复
GB1012国标通道绑定数量超过限制，请联系商务
GB1013国标设备ID错误
GB1014国标设备未接入，不支持该操作
GB1015国标任务ID错误或已过期
GB1016国标创建任务正在进行中，请稍后查询
MC1001账号未开通消息通道权限，请提交工单联系
MC1002group参数的合法值为group1、group2、group3，请修改
MC1003当前没有需提交的offset
VT1001账户没有该项目
VT1002删除项目时有正在进行的任务,不能删除
VT1003删除项目时项目下有文件存在,不能删除
VT1004用户没有该文件
VT1005该文件下载时间已过期,请重新获取下载地址
VT1006时间段内无可录内容
VT1007用户没有该任务
VT1008该任务状态不能被终止
WC1001miniToken不存在或者已过期
接口调用限制说明
云平台能力说明