本页目录
如何阅读
通用成功码
开放平台通用
签名与请求校验
Token 鉴权
设备与通道
Wi-Fi 配网
短信验证码
短信发送限额
消息回调与安全码
云存储套餐
云录像
直播地址
本地录像计划
角色与用户授权
设备分组
用户与订单
P2P 取流鉴权
综治员绑定
设备本地存储
配件
接入额度与流量
人脸库与 AI 分析
用户登录
手机号变更
子账号

错误码

错误码

HTTP 响应里 result.code 为字符串。0 表示成功；失败时除 msg 外，码值首段 字母前缀 表示错误来源（例如 SN1002 属于签名类、DV1016 属于设备类）。本页按业务场景合并展示完整码表；各 API 方法页「错误码」节引用与本页相同的分表内容（见 错误码 各节锚点）。

如何阅读

  1. 看 result.code 首段字母（到第一个数字前），用右侧 本页目录 或浏览器页内搜索定位对应业务节。
  2. 签名、Token 类多与 调用约定、签名、获取 token 有关。
  3. 设备与通道类请对照设备能力、绑定态与接口备注。
  4. HTTP 状态码 200 时仍可能有业务 code 非 0；以 body 内 result.code 为准。
  5. 本页码表仅覆盖 OpenAPI 网关/业务 HTTP（result.code）。device.service.invoke、能力 property 等返回体内的设备侧 outputData.code 或 TSL 枚举属于设备执行结果，不在此表检索；见各能力页与 设备服务调用（若已发布）。
  6. 场景描述中出现「提交工单」「提升限额」时，统一通过 问题解决渠道 联系平台（控制台工单、商务等）。

通用成功码

下表为无字母前缀的成功码；其余按业务场景见下文各节。

错误码错误码描述场景描述
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 的取值与请求当时的时间戳要求不能偏差超过 5 分钟，请检查后重试
SN1003签名参数错误请求体中，system.time 不是数值（含字母或特殊字符）
SN1004非法的 appId非法的 appId
SN1005重复的 nonce重复的 nonce。开发者向开放平台调用接口时传入的 nonce 在 5 分钟内不能重复，否则会返回此错误码

Token 鉴权

错误码错误码描述场景描述
TK1001该账户（phone）对应的用户与您的应用已绑定
TK1002token 已过期或不存在，请重新获取 tokenaccessToken 超过有效期或未传 token 时返回
TK1003非法 token，请传入正确的 token请检查 token 和 appId 是否对应。如果多个 appId 账号的 token 异常混用，会返回该错误码
TK1004当前用户的手机号码还未跟您的应用绑定请先完成「用户绑定」后再获取 token
TK1005绑定用户数量超出限制非发布状态的 app 绑定用户数量超出限制
TK1006当前手机号码不是开发者账号的手机号码，开发者创建应用后，在开放平台网站>开发中心>应用详情页中可以找到管理员账号一项。
TK1007还未得到当前用户的授权，请先进行“用户授权绑定”操作。
TK2001失效的 csrfToken

设备与通道

错误码错误码描述场景描述
DV1001设备已被其他账号绑定
DV1002设备不存在
DV1003设备已被当前账号绑定
DV1004更新通道名称失败
DV1005设备验证码错误
DV1006无需更新设备，设备已是最新版本
DV1007设备离线或超时设备不在线、休眠或设备侧响应超时
DV1008绑定设备数量超出限制，请先解绑其他冗余设备非发布状态的 app 绑定设备数量超出限制。
DV1009设备正忙，请稍后再试需要操作的设备正在处理前一请求
DV1010抓图请求过于频繁，请稍后再试抓图接口调用过于频繁，1s 内同一设备抓图请求多次
DV1011设备未添加，请先绑定设备需要操作的设备并未被当前账号添加
DV1012权限不足，该设备属于被授权（或被共享）设备
DV1013设备注册 3 天后绑定，客户端与设备必须在同一局域网内；设备断电重启后即可再次绑定。注册超过 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本地操作关联。

Wi-Fi 配网

错误码错误码描述场景描述
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设备已经自定义加密密钥绑定或播放直播时，设备已开启自定义视频加密且密钥不匹配
LV1008需实名认证在开放平台完善主体信息后重试
LV1005直播信息不存在。
LV1006操作失败，同一 rtsp 源地址同一天内仅能被绑定 1 次。
LV1020已绑定直播,无法删除
LV1040该直播无权限操作。
LV1041无权限操作此设备。
LV1055设备4G套餐类型不符合，请使用开放平台4G套餐或联系官方客服

本地录像计划

错误码错误码描述场景描述
YL1001定时拉取模式下，拉取的时间点不能在定时录像计划时间内。
YL1002定时计划时间参数重合，重合时间为 XX-XX。返回信息中的 XX-XX 为平台给出的重合时间段，请调整计划后重试
YL1003操作失败，存在有效的云存储录像计划，请关闭云存储录像计划后重试。
YL1004操作失败，存在有效的动检计划，请关闭动检计划后重试。
YL1005操作失败，请开通支持设置云存储录像计划的云存储策略套餐。云存储录像计划只支持连续云存储套餐操作，不支持事件云存储

角色与用户授权

错误码错误码描述场景描述
GT1001授权角色已经存在
GT1002添加角色失败
GT1003用户授权已经存在
GT1004创建用户授权失败
GT1005用户授权不存在
GT1006角色不存在
GT1007角色为默认角色
GT1008授权超过限制
GT1009不能授权给自己
GT1010获取授权列表失败
GT1011获取权限列表所传参数有误

设备分组

错误码错误码描述场景描述
GP1001设备分组名称已经存在
GP1002设备分组 Id 不存在
GP1003设备已被添加至分组

用户与订单

错误码错误码描述场景描述
US1001用户不存在
US1002该用户不存在这个授权关系
US1003订单与用户校验未通过。

P2P 取流鉴权

错误码错误码描述场景描述
P2P001P2P 鉴权接口，鉴权 ID 已过期
P2P002P2P 鉴权接口，头部域参数缺失
P2P003token 过期
P2P004没有设备权限

综治员绑定

错误码错误码描述场景描述
AD1001未绑定综治员

设备本地存储

错误码错误码描述场景描述
LD1001设备本地无存储介质

配件

错误码错误码描述场景描述
AP1001配件不存在
AP1002配件离线

接入额度与流量

错误码错误码描述场景描述
FL1001开发者剩余接入数不足开发者新增设备接入，会消耗接入额度。当接入额度不足时，无法新绑定设备。可以通过开放平台网站-控制台-我的资源 查看设备接入额度是否超限
FL1002开发者当前无可用带宽播放设备视频时（实时预览、录像回放），需要消耗带宽或流量。当开发者无剩余流量，并且也未购买带宽，则返回错误信息。可以通过开放平台网站-控制台-我的资源 查看剩余流量和带宽额度
FL1003开发者当前使用带宽超过额度限制播放设备视频时（实时预览、录像回放），需要消耗带宽或流量。当开发者的带宽使用超过限额，则返回错误信息。可以通过开放平台网站-控制台-我的资源 查看带宽额度信息
FL1004开发者剩余流量不足播放设备视频时（实时预览、录像回放），需要消耗带宽或流量。当开发者无剩余流量，并且也未购买带宽，则返回错误信息。可以通过开放平台网站-控制台-我的资源 查看剩余流量信息
FL1005开发者音视频取流操作时没有可用带宽且剩余流量不足播放设备视频时（实时预览、录像回放），需要消耗带宽或流量。当开发者无剩余流量，并且也未购买带宽，则返回错误信息。可以通过开放平台网站-控制台-我的资源 查看剩余流量和带宽额度
FL1006已达到个人版套餐3路并发上限，请升级企业套餐
FL1008子账号流量使用达到上限。
FL1009设备通道流量使用达到上限。

人脸库与 AI 分析

错误码错误码描述场景描述
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子账号创建失败，账号已存在重复绑定子账号到应用下
获取 token
限额与频率