Error codes

Look up a returned code here for meaning and next steps. Each API and capability leaf embeds likely codes in its own Error codes section (same as domestic docs); use this page when you need the full DV20xx catalog. Alarm device.message.list / search / delete share fragment dv20-message.md (see Query alarm history “Error codes”): unauthorized events are filtered per row, not a whole-call DV2011.

Callback URL and callbackFlag issues are configured through Push configuration and Receive device messages, not the DV20xx tables below.

msg includes field names and reasons. For writes (set / invoke), timeout does not mean the operation did not run. Only minute rate limit OP1039 should backoff to the next minute.

Gateway codes and business codes are listed together. Full platform set: Global return codes.

Gateway codes

Code	Meaning	Next step
`SN1001`	Signature error	Verify `sign` per Signing
`TK1002`	Token invalid or expired	Obtain a new token
`OP1002`	Missing required parameter	Add required fields
`OP1003`	Invalid parameter	Check parameter table on the API page
`OP1039`	Per-minute rate limit	Retry next minute
`OP1040`	Call quota exceeded	Reduce frequency
`DV1007`	Device offline or timeout	Wait for device online

Capability errors (DV20xx)

Code	Meaning	Next step
`DV2001`	Invalid `propertyId` / `serviceId` / `eventId`, or not in catalog	Check Capability usage
`DV2002`	Request keys do not map to catalog entries	Use `propertyId` / `serviceId` from list
`DV2003`	In catalog but not declared on this device	Trust this `capability.list` response
`DV2004`	Value out of range for this model	Follow list `dataType`; switches use `0`/`1`
`DV2005`	Operation not allowed (e.g. write to read-only property)	Do not set read-only items
`DV2006`	Mixed identifiers for one item in one request	Use only list `propertyId` / `serviceId`
`DV2007`	`channelId` does not match `scope`	Required for channel scope; omit for device scope
`DV2008`	Device-level and channel-level mixed in one request	Split into two calls
`DV2009`	`productId` does not match device model	Omit `productId` or use actual model
`DV2010`	Device cannot complete operation via this API now	Omit `productId` and retry
`DV2011`	No permission for this capability	See Permission codes
`DV2012`	Device does not exist	Verify serial number
`DV2013`	Device not bound	Bind first. Not used for `device.capability.list`
`DV2014`	Missing required member	Add fields marked `required` in list

Device-side errors (DV21xx)

Only these DV21xx codes appear on outbound responses.

Code	Meaning	Next step
`DV2101`	SDK not ready; re-init needed	Retry later
`DV2102`	Device network disconnected	Check device network
`DV2103`	Device not connected to platform	Wait for online
`DV2104`	Device-side timeout	Retry reads; avoid blind retries on writes
`DV2105`	Device out of memory/resources	Retry later
`DV2106`	Device protocol/format error	Check input shape
`DV2107`	Device register/login failed	Check device state
`DV2108`	Device authentication failed	Check password / security code
`DV2109`	Wrong username or password	Verify password
`DV2110`	Locked after too many auth failures	Wait for unlock
`DV2111`	Signature, timestamp, or replay check failed	Verify sign and time
`DV2112`	Wi-Fi parameters wrong	Check SSID/password
`DV2113`	Identity mismatch (model/serial)	Verify serial and model
`DV2114`	Invalid SIM	Verify card number
`DV2115`	Invalid method or URL	Verify path
`DV2116`	Capability or request not supported	Compare with list
`DV2117`	Property, service, event, or resource missing on device	Compare with list
`DV2118`	Invalid parameter or property value	Fix per allowed values
`DV2119`	No device callback registered	Retry or use another API
`DV2120`	Read-only on device	Do not write
`DV2121`	Count or config limit reached	Delete then create
`DV2122`	Target already exists	Rename or skip
`DV2123`	Preconditions not met	Read `msg`; wake sleeping device first
`DV2124`	Talk busy or call ended	Retry later
`DV2125`	Low battery; operation refused	Charge and retry
`DV2126`	Upgrade failed	Check `device.upgrade.process`
`DV2127`	Device internal error	Retry later
`DV2128`	Device not initialized	Complete initialization
`DV2129`	Already initialized or init failed	See `msg`
`DV2130`	Sub-device operation failed	Check sub-device
`DV2131`	Sub-device not found	Verify sub-device serial
`DV2132`	Storage media error	Check SD/HDD
`DV2133`	Name conflict	Rename
`DV2134`	Insufficient permission on device	Verify permissions
`DV2199`	Unmapped device-side error	Read `msg` in response body

Extra codes on specific APIs

Code	Meaning	Appears on
`DV1006`	Already latest	Trigger upgrade
`DV1016`	Wrong password	Verify password, Change password