1. Error and Codes
Sifely Open API
  • Overview
  • Quick start
  • API Use Cases
    • Hospitality & Vacation Rental
  • OAuth Manager
    • Login
      POST
    • Get token refresh token
      POST
  • Key Manager
    • Get Ekeys by account
      POST
    • Send ekey
      POST
    • Delete ekey
      POST
  • Passcode Manager
    • Random a passcode with offline
      POST
    • Create passcode
      POST
    • Change passcode
      POST
    • Delete passcode
      POST
    • Get passcode
      GET
    • Delete passcode by code
      POST
  • Lock Manager
    • Unlock a lock via gateway
      POST
    • Lock the lock via gateway
      POST
    • Get lock details
      GET
    • Get keys of a lock
      GET
    • Passcode list
      GET
    • Get Lock open state
      GET
    • Get the owner lock list of an account
      POST
  • Group Manager
    • Group list
      GET
  • Card Manager
    • Get IC card list
    • Assigns IC card
    • Delete a IC card from a lock
  • FingerPrint Manager
    • FingerPrint list
  • Records Manager
    • Get unlock records by lockId
  • Gateway Manager
    • Gateway details
    • Lock's gateways
    • Gateway's locks
  • Webhooks
    • Setup & Authentication
    • Payload Reference
  • Error and Codes
    • Error Codes
  • Schemas
    • KeyInfo
    • CardInfo
    • FingerInfo
    • CardAddDTO
    • GroupInfo
    • LockDetailDTO
    • LockVersion
    • GatewayDetailDTO
    • OpenStateDTO
    • OauthDTO
    • PwdAddDTO
    • PwdInfo
    • ListByLockDTO
    • ListData«ListByLockDTO»
    • YesOrNotDTO
    • Page«CardInfo»
    • Page«FingerInfo»
    • ListData«ListLockDTO»
    • ResultWrapper«Map«string,string»»
    • Page«GroupInfo»
    • ListLockDTO
    • Page«KeyInfo»
    • Page«PwdInfo»
    • Page«RecordInfo»
    • RecordInfo
    • ResultWrapper«SysAppClientDetails»
    • ResultWrapper«object»
    • SysAppClientDetails
  1. Error and Codes

Error Codes

Error Codes#

1. Account, Permission & General#

Error CodeDescription
0Operation succes
1Operation failed
90000System internal error
-1Parameter error
-2018App permission error; many interface materials are provided for developers or customized accounts only. Please use the developer account to obtain permission.

2. Lock Related#

Error CodeDescription
-1003Lock does not exist
-2005Lock is initialized; operation unavailable
-4011Invalid initialization data
-4015The current lock is not authorized
-4016Inconsistent lock handle and ID
-4017The lock has been deleted; operation unavailable
-4032Door sensor type mismatch

3. eKey Related#

Error CodeDescription
-1008eKey does not exist
-1016eKey expired; please re-enter
-1018eKey inactive
-1027The eKey is already bound to another account and cannot be claimed
-2019Invalid QR code or expired
-2020Invalid QR code; please refresh
-2023No permission for current account
-4004Unbinding failed; lock is not registered. Please register first.

4. Password Related#

Error CodeDescription
-1007Password does not exist or password error
-2009Code does not exist
-3006Password length must be 4-9 digits
-3007Password expired; please reset
-3008Cannot reset to previously used password
-3009Custom password error; please ensure content is correct and try again

5. Gateway & WiFi Lock Related#

Error CodeDescription
-2012Gateway does not exist
-3002Gateway type error; check configuration
-3003Gateway busy; please try again later
-3006Inconsistent illegal scope
-3014WiFi configuration failed; please check network environment
-3015WiFi lock configuration failed; please check lock battery/environment
-3016Configuration timed out; please try again
-3017Gateway busy; please wait
-4007Gateway does not exist

6. IC Card & Fingerprint Related#

Error CodeDescription
-1021IC Card does not exist
-1023Fingerprint does not exist
Modified at 2026-04-27 11:20:31
Previous
Payload Reference
Next
KeyInfo
Built with