Get Identifier Entity

Returns detailed info about Identifier

Path Parameters

• identifierUid integer required

  Possible values: >= 1

  Unique Id for physical/input code identifier

Responses

• 200
• 400
• 401
• 403

---

OK

application/json

• Schema
• Example (from schema)
• Example

---

Schema

• identifier_owner object

  name string

  type string

  Possible values: [owner, guest]

• identifier_type string

  Possible values: [card, ukey, inputCode, face_id, qr, license_plate]

• identifier_number string

  • hex, number or face eiginvalue data in Base64 - This param isn't required if you crete face identifier by uploading image

  • hex or dec if identifier_type is card or ukey

  • dec if identifier_type is inputCode

  • uuid if identifier_type is qr

  • pattern for hex and dec - [0-9]{1,10} or ([0-9A-Fa-f]{2}[:-]){1,7}([0-9A-Fa-f]{2})

• lock string

  Possible values: [first, second, all]

• valid object

  time object

  is_permanent boolean

  from int64

  Unix Timestamp Date

  to int64

  Unix Timestamp Date

  passes object

  is_permanent boolean

  max_passes integer

  Possible values: >= 1

• apartment object

  uid integer

  Possible values: >= -1

  UID for entities referenses. If value is -1, then it means that is no entity reference for this structure

  logical_address object

  Logical address - an entity defines the device/user address in the address hierarchy and is used during a call, issuing identifiers, creating call forwarding rules etc.

  building integer

  Possible values: >= 1 and <= 9999

  Building number

  unit integer

  Possible values: <= 99

  Unit number

  floor integer

  Possible values: <= 98

  Floor number

  room integer

  Possible values: <= 99

  Room number

• time_profiles object

  Model used to providing array of UIDs of various enumerated entities stored in the panel, such as apartments, identifiers, forward, and similar

  uid_items integer[]

  Possible values: >= -1

  Array of UID for entities referenses.

  count integer

  The number of values in the array

• additional object

  passes_left integer

  Possible values: >= -1

  if access is permanent - return -1 value

{
  "identifier_owner": {
    "name": "Sherlock Holmes",
    "type": "owner"
  },
  "identifier_type": "ukey",
  "identifier_number": "12345678",
  "lock": "first",
  "valid": {
    "time": {
      "is_permanent": false,
      "from": 1540819272,
      "to": 1540819272
    },
    "passes": {
      "is_permanent": false,
      "max_passes": 3
    }
  },
  "apartment": {
    "uid": 3,
    "logical_address": {
      "building": 1,
      "unit": 1,
      "floor": 1,
      "room": 1
    }
  },
  "time_profiles": {
    "uid_items": [
      11,
      13,
      23,
      42
    ],
    "count": 4
  },
  "additional": {
    "passes_left": 3
  }
}

{
  "identifier_owner": {
    "name": "Sherlock Holmes",
    "type": "owner"
  },
  "identifier_type": "ukey",
  "identifier_number": "12345678",
  "lock": "first",
  "valid": {
    "time": {
      "is_permanent": false,
      "from": 1540819272,
      "to": 1540819272
    },
    "passes": {
      "is_permanent": false,
      "max_passes": 3
    }
  },
  "apartment": {
    "uid": 3,
    "logical_address": {
      "building": 1,
      "unit": 1,
      "floor": 1,
      "room": 1
    }
  },
  "time_profiles": {
    "uid_items": [
      11,
      13,
      23,
      42
    ],
    "count": 4
  },
  "additional": {
    "passes_left": 3
  }
}

Wrong Identifier uid

application/json

• Schema
• Example (from schema)
• Wrong Identifier uid

---

Schema

• error string

{
  "error": "Wrong JSON body"
}

{
  "error": "Wrong Identifier uid"
}

Unauthorized request. Log In

application/json

• Schema
• Example (from schema)
• Log In

---

Schema

• error string

{
  "error": "Log In"
}

{
  "error": "Log In"
}

Administrator rights required. You are currently logged in with different user account. Log In with administrator rights

application/json

• Schema
• Example (from schema)
• Admin Rights Required

---

Schema

• error string

{
  "error": "Administrator rights required"
}

{
  "error": "Administrator rights required"
}

Loading...