1. Card Manager
Sifely Open API
  • Overview
  • Rates & Availability API
  • API Use Cases
    • Hospitality & Vacation Rental
  • 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
      GET
    • Assigns IC card
      POST
    • Delete a IC card from a lock
      POST
  • FingerPrint Manager
    • FingerPrint list
  • Records Manager
    • Get unlock records by lockId
  • Door sensor Manager
    • Get door sensor records.
  • 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
    • DoorSensorRecordInfoDTO
    • GroupInfo
    • Page«DoorSensorRecordInfoDTO»
    • 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. Card Manager

Assigns IC card

POST
/v3/identityCard/add
After the card reader reads the card number, it assigns the card number to a lock

Request

Authorization
API Key
Add parameter in header
Authorization
Example:
Authorization: ********************
or
Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff --request POST '/v3/identityCard/add?addType=2&cardName=undefined&cardNumber=undefined&endDate=undefined&lockId=undefined&startDate=undefined&cyclicConfig=[{%22weekDay%22%3A1%2C%20%22startTime%22%3A480%2C%22endTime%22%3A1080}%2C{%22weekDay%22%3A2%2C%20%22startTime%22%3A480%2C%22endTime%22%3A1080}]&cardType=' \
--header 'Authorization: <api-key>'

Responses

🟢200成功
*/*
OK
Body*/*

Example
{
    "cardId": 0
}
🟢201已创建
🟠401未认证
🟠403权限不足
🟠404未找到
Modified at 2026-05-22 03:19:52
Previous
Get IC card list
Next
Delete a IC card from a lock
Built with