1. Account, Permission & General#
| Error Code | Description |
|---|
| 0 | Operation succes |
| 1 | Operation failed |
| 90000 | System internal error |
| -1 | Parameter error |
| -2018 | App permission error; many interface materials are provided for developers or customized accounts only. Please use the developer account to obtain permission. |
| Error Code | Description |
|---|
| -1003 | Lock does not exist |
| -2005 | Lock is initialized; operation unavailable |
| -4011 | Invalid initialization data |
| -4015 | The current lock is not authorized |
| -4016 | Inconsistent lock handle and ID |
| -4017 | The lock has been deleted; operation unavailable |
| -4032 | Door sensor type mismatch |
| Error Code | Description |
|---|
| -1008 | eKey does not exist |
| -1016 | eKey expired; please re-enter |
| -1018 | eKey inactive |
| -1027 | The eKey is already bound to another account and cannot be claimed |
| -2019 | Invalid QR code or expired |
| -2020 | Invalid QR code; please refresh |
| -2023 | No permission for current account |
| -4004 | Unbinding failed; lock is not registered. Please register first. |
| Error Code | Description |
|---|
| -1007 | Password does not exist or password error |
| -2009 | Code does not exist |
| -3006 | Password length must be 4-9 digits |
| -3007 | Password expired; please reset |
| -3008 | Cannot reset to previously used password |
| -3009 | Custom password error; please ensure content is correct and try again |
| Error Code | Description |
|---|
| -2012 | Gateway does not exist |
| -3002 | Gateway type error; check configuration |
| -3003 | Gateway busy; please try again later |
| -3006 | Inconsistent illegal scope |
| -3014 | WiFi configuration failed; please check network environment |
| -3015 | WiFi lock configuration failed; please check lock battery/environment |
| -3016 | Configuration timed out; please try again |
| -3017 | Gateway busy; please wait |
| -4007 | Gateway does not exist |
| Error Code | Description |
|---|
| -1021 | IC Card does not exist |
| -1023 | Fingerprint does not exist |
Rate & Quota Limit Adjustments (429)#
| Error Code | HTTP | Description | Details |
|---|
| 50501 | 429 | The request count limit has been exceeded (X requests/minute|hour) | Minute/Hour anti-abuse bucket limit exceeded |
| 50502 | 429 | The daily request count limit has been exceeded (X requests/day) | Daily anti-abuse bucket limit exceeded |
| 50503 | 429 | Monthly call quota exceeded (<plan> plan: <quota> calls/month) | Monthly call quota exceeded (Hard block for hard_limit DEVELOPER plans only) |
| 50504 | 429 | Device count N exceeds plan <plan> quota (<quota>) | Device count exceeds plan limit (Hard block for hard_limit plans only) |
| Error Code | HTTP | Description |
|---|
| 50201 | 402 | Subscription is not active |
| 50202 | 402 | No active subscription. Please subscribe to a plan — plan=none (Unsubscribed/Cancelled) |
Modified at 2026-06-18 06:56:36
