Getting Started
Official Site
Getting Started
Official Site
  • Document description
  • Read before you start

  • Light application development guide

  • Mobile application development guide

  • Cloud live development guide

  • Desktop application development guide

  • Third party development guide

  • Message push development guide

  • IoT things data model

  • HTTP interface

  • Reference documents

    • Device capability switch
    • Device capability set
    • Interface call limit description
    • Global return code description
    • OEMApp Service And Software License Agreement

Global Return Code Description for API Integration - Imou Open Platform

Global return code description

When calling the HTTP API interface of the open platform, you may get a correct or incorrect return code. Developers can debug the interface based on the return code information and troubleshoot errors.

Error codeError code descriptionScene description
0Successful operation
OP1001Operation failed
OP1002The parameter is missing, please confirm whether the parameter is missingIn the request body, a required item does not exist in the params
OP1003The parameter value is illegal (the parameter format is wrong or empty), please correct the parameter value1. In the request body, there is a required item that is empty ("" or null); 2. There are regulations stipulated in the participation agreement The parameter type does not match; 3. The format of the passed parameter does not conform to the legal value description
OP1004Request content is emptyRequest content is empty
OP1005Invalid request URLInvalid request URL
OP1006SDK exception1. When calling the SDK, the head in the request body is empty; 2. There are fields in the head that are missing; 3. There are fields in the head that are empty
OP1007Invalid method call1. When external interface is called, system.appId is empty ("" or null); 2. When non-user module interface is called, params.token does not exist or params.token is empty ("" Or null)
OP1008appId is emptysystem.appId value does not meet specifications
OP1009Insufficient permissions to perform this operation1. The device is not bound by the current user; 2. When the live interface is called, the appId is not in the whitelist; 3. When the live interface is called, the token is not an administrator token
OP1010The application is frozenThe current App status is frozen
OP1011The number of calls to the interface on the day has reached the upper limitWhether the call of the non-published app exceeds the limit
OP1012Insufficient authority to call the interfaceInsufficient authority to call the interface
OP1013The number of interface calls exceeds the limit (total number)For some interfaces with a total number of calls limit, if the developer calls more than the configured number of times limit, this error code will be returned
OP1014The number of interface calls exceeds the limit (per day)For some interfaces that have a limit on the total number of calls per day, if the developer calls more than the configured number of times limit, this error code will be returned
OP1015Insufficient permissions to perform this operation. (The device is not an open platform bound device)Insufficient permissions to perform this operation. (This device is not an open platform binding device)
OP1016The requested device-related interface reaches the limit.The number of device channels that the developer can operate each week cannot exceed the number of device accesses purchased by the current developer
OP1019No video generated during this time periodNo video generated during this time period
OP1021Failed to obtain the playback addressFailed to obtain the playback address
OP1023kitToken has expired, please re-acquirekitToken has expired, please re-acquire
OP1026Requests are too frequent, please try again later.When the same user requests the same token-related interface at the same time, this error code will appear in rare cases
SN1001Signature exceptionIn the request body, the value of system.sign is inconsistent with the signature value calculated by OpenApi
SN1002Signature timeoutIn the request body, the value of system.time should not deviate from the timestamp of the request by more than 5 minutes
SN1003Signature parameter errorIn the request body, system.time is not a numeric value (including letters or special characters)
SN1004Illegal appidIllegal appId
SN1005Duplicate nonceDuplicate nonce. The nonce passed in when the developer calls the interface to the open platform cannot be repeated within 5 minutes, otherwise this error code will be returned
TK1001The user corresponding to this account (phone) has been bound to your application
TK1002Token has expired or does not exist, please re-acquire tokenToken has expired or does not exist, please re-acquire token
TK1003Illegal token, please pass in the correct tokenPlease check if the token and appId correspond. If the tokens of multiple appId accounts are mixed abnormally, this error code will be returned
TK1004The current user's mobile phone number has not been bound to your applicationPlease perform "user binding" first to perform user binding operation
TK1005The number of bound users exceeds the limitThe number of non-published app binding users exceeds the limit
TK1006The current mobile phone number is not the mobile phone number of the developer account. After the developer creates the application, you can find the administrator account in the open platform website> Development Center> Application Details page.
TK2001Invalid csrfToken
DV1001The device has been bound to another account
DV1002Device does not exist
DV1003The device has been bound to the current account
DV1004Failed to update channel name
DV1005Device verification code error
DV1006No need to update the device, the device is already the latest version
DV1007Device offline
DV1008The number of bound devices exceeds the limit, please unbind other redundant devices firstThe number of non-published app bound devices exceeds the limit.
DV1009The device is busy, please try again laterThe device that needs to be operated is processing the previous request
DV1010The image request is too frequent, please try again laterThe image capture interface is called too frequently, and the same device has multiple requests for image capture within 1s
DV1011The device has not been added, please bind the device firstThe device to be operated has not been added by the current account
DV1012Insufficient permissions, the device is an authorized (or shared) device
DV1013The device is bound after 3 days of registration. The client and the device must be in the same local area network. The device can be bound again when the device is powered off and restarted.
DV1014Device binding error exceeds 10 consecutive times, limit binding for 30 minutes
DV1015Device binding error exceeds 20 consecutive times, limit binding for 24 hours
DV1016The device password is incorrect.
DV1018The device is registered to the platform and has not been bound for more than three days. It needs to be bound in the local area network or the device is bound after restartingThe device has not been bound for more than three days after being registered on the platform
DV1019Device capability set does not support this operation
DV1020The device channel is offline.
DV1021The device is abnormal.
DV1022The number of favorite points exceeds the limit
DV1023Favorite point already exists
DV1024Collection point does not exist
DV1025Device SC code or device password error
DV1026The device does not support the call of this function
DV1027Device security code error
DV1028The user has not bound the device or the device channel number does not exist
DV1029The device has been bound
DV1030Device is sleeping
DV1031Low battery refused to upgrade (with battery equipment)
DV1034Device not initialized
DV1035Device initialization failed
DV1036Logout failed, the device has not been offline for 5 minutes
DV1037The imei and device id of the NB device do not match
DV1038Cannot add temporary key when battery is low
DV1039Temporary key generation does not meet the conditions
DV1040The device has been failed to bind 20 times. Limit binding for 24 hours
DV1041The number of transfer devices exceeds the set maximum value
DV1042The device password is incorrect for the limited number of times, and the device is locked
DV1043Project attributes are not supported
DV1044Device IP is not in the unified LAN
DV1045Device conflict
DV1047The device has customized encryption
DV1049The device has no storage medium
DV1050The number of generations of temporary keys exceeds the limit
DV1051Face database does not exist
DV1052Add more than the upper limit of the face database
DV1053Failed to capture the picture, please check the networkWhen calling the manual capture interface, the device did not return the picture in time due to network reasons.
WF1001Request timeoutConnection wifi timeout
WF1002Wrong wifi passwordWhen connecting to wifi, the params.password in the request body is wrong
SM1001Verification code input error1. When binding the user, params.smsCode is filled in incorrectly; 2. When binding the user, the verification code has expired.
SM1002The verification code has expired, please re-acquire the verification code
SM1003Server processing error
SM1004Failed to send verification code SMS
SM1005The number of times to obtain SMS verification codes on the same day has reached the upper limit1. When a non-published app is bound to a user, the number of times to obtain a SMS verification code exceeds the limit; 2. When a published app is bound to a user, the number of times to obtain a SMS verification code exceeds the limit Restrictions;
SM1006SMS is sent too frequently, please try again laterGet SMS interface calls too frequently
SMS01The number of SMS sending exceeds the limit
SMS02The number of SMS sending exceeds the limit
TH1001The current method is wrong, not the transparent transmission interface method
TH1003The format of the message callback URL is incorrect
ST1001The default cloud storage package of the current device has expired, and the operation failedWhen the default cloud storage package is turned on, the default package has expired
ST1002The current device has no default cloud storage package, the operation failed
ST1003The cloud storage package currently in use is not the default cloud storage package, and the operation failed
ST1004Cloud storage package is not open
ST1005Cloud storage package has expired
ST1006Cloud storage package does not exist
ST1007The number of calls to activate the cloud storage interface is less than once
ST1008The timed recording plan cloud storage package used by the current device is in use and needs to be suspended
ST1009The operation failed. The current device still has an unexpired charging cloud storage package policy.
ST1010The device does not support the corresponding cloud storage package strategy
RC1001Cloud video not foundQuery cloud video based on cloud video clip information does not exist
LV1001The live video already existsWhen the bind live address interface is called, the current device and rtsp address source have been bound to the live broadcast address
LV1002The live video does not exist
LV1004The device has customized the encryption keyWhen the live broadcast plan is turned on, the traffic is insufficient
LV1005The live broadcast information does not exist.
LV1006The operation failed. The same rtsp source address can only be bound once in the same day.
LV1008Real-name authentication is required to create a live broadcast. Please go to the open platform website-basic information page to complete the information. If you are an individual user, please upload your ID card. If you are a company customer, please upload your business license and others
LV1020Live broadcast has been bound and cannot be deleted
YL1001In the timing pull mode, the pull time cannot be within the scheduled time of the timing recording.
YL1002The timing plan time parameter overlaps, the overlap time is XX-XX.
YL1003The operation failed. A valid cloud storage recording plan exists. Please close the cloud storage recording plan and try again.
YL1004The operation failed. There is a valid motion inspection plan. Please close the motion inspection plan and try again.
YL1005The operation failed. Please activate the cloud storage strategy package that supports the setting of cloud storage recording plans.
GT1001Authorized role already exists
GT1002Failed to add character
GT1003User authorization already exists
GT1004Failed to create user authorization
GT1005User authorization does not exist
GT1006Character does not exist
GT1007The role is the default role
GT1008Authorization exceeds limit
GT1009Cannot authorize to myself
GT1010Failed to obtain authorization list
GT1011The parameter passed in the access permission list is incorrect
GP1001The device group name already exists
GP1002Device group Id does not exist
GP1003The device has been added to the group
US1001User does not exist
US1002This user does not have this authorization relationship
P2P001P2P authentication interface, authentication ID has expired
P2P002P2P authentication interface, the header field parameter is missing
P2P003token expired
P2P004No device permission
AD1001Unbound general manager
LD1001There is no storage medium locally on the device
AP1001Accessory does not exist
AP1002Accessories offline
FL1001Insufficient number of remaining accesses for developersDevelopers can log in to the open platform website and click on "purchased resources" to view the remaining number of device channel accesses
FL1002Developer currently has no available bandwidthDuring audio and video preview (real-time preview, video playback), the system detects that the developer has no remaining traffic and has not purchased bandwidth, and an error message will be returned. Developers can log in to the open platform website and click "purchased resources" to view the remaining traffic and available bandwidth.
FL1003The developer's current bandwidth exceeds the quota limitDuring audio and video preview (real-time preview, video playback), the system detects that the developer's bandwidth usage exceeds the limit, and an error message is returned. Developers can log in to the open platform website and click Console-My Resources to view the remaining traffic and available bandwidth.
FL1004Insufficient developer's remaining trafficDuring audio and video preview (real-time preview, video playback), the system detects that the developer has no remaining traffic and has not purchased bandwidth, and an error message will be returned. Developers can log in to the open platform website and click "purchased resources" to view the remaining traffic and available bandwidth
FL1005There is no available bandwidth and insufficient remaining traffic during the audio and video fetching operation of the developerDuring the audio and video preview (real-time preview, video playback), the system detects that the developer has no remaining traffic and has not purchased bandwidth, and an error message is returned . Developers can log in to the open platform website and click "purchased resources" to view the remaining traffic and available bandwidth.
PF1001repositoryToken does not exist
PF1002faceToken does not exist
PF1003No face detected
PF1004This function is temporarily not supported
PF1005Picture size exceeds 2M limit
PF1006Type does not match
PF1007Failed to obtain feature value, please perform image detection first
UR1000User not logged in
UR1001Email login is not supported
PH1001Mobile phone number modification frequency has reached the upper limit
ST1011The number of calls to the interface exceeds the limit, and the same package can only be unbound once within 24 hours
ST1012Free cloud storage does not support unbinding
SUB1000The current sub-account has no interface access rights
SUB1001The current sub-account has no interface access rights
SUB1002The current sub-account has no interface access rights
SUB1005Sub-account token expired
SUB1006No authorization relationship between sub-account and device
SUB1007Failed to create sub-account
SUB1008There is no binding relationship between the sub-account and the current application
Interface call limit description
OEMApp Service And Software License Agreement