Get identifiers list

Returns identifiers list with options could be used to sort them

Query Parameters

• limit integer required

  Possible values: [10, 20, 30, 50]

  Default value: 10

  Number of items. Value by default is 10

• pageNumber integer required

  Possible values: >= 1

  Default value: 1

  Page number

• sortField string

  Field name (JSON Key in item entity)

• sortType string

  Possible values: [asc, desc]

  Default value: asc

  Sort type (asc/desc)

• filter object

  Filtering options

Responses

• 200
• 400
• 401

---

OK

application/json

• Schema
• Example (from schema)
• Example

---

Schema

• list_items object[]
• list_option object

  Available options for sorting, filtering and pagination of lists

  pagination object

  Available pagination options for tables

  total_items integer

  The total number of items found and reflected across all pages

  items_limit integer

  Possible values: [10, 25, 50]

  Limiting the display of the amount of data for one page

  total_pages integer

  Possible values: >= 1

  The number of pages that hold the requested data

  current_page integer

  Possible values: >= 1

  Current page number

  sort object

  field string

  asc boolean

  available_fields string[]

  Possible values: [identifier_number, name]

{
  "list_items": [
    {
      "identifier_id": 1,
      "identifier_owner": {
        "name": "Sherlock Holmes",
        "type": "owner"
      },
      "identifier_type": "ukey",
      "identifier_number": "123456ABCD",
      "lock": "first",
      "time": {
        "is_permanent": false,
        "from": 1540819272,
        "to": 1540819272
      },
      "passes": {
        "is_permanent": false,
        "max_passes": 3
      },
      "apartment": {
        "uid": 4,
        "logical_address": {
          "building": 1,
          "unit": 2,
          "floor": 3,
          "room": 4
        }
      },
      "time_profiles": {
        "count": 4,
        "uid_items": [
          11,
          13,
          23,
          42
        ]
      }
    },
    {
      "identifier_id": 2,
      "identifier_owner": {
        "name": "Sherlock Holmes",
        "type": "owner"
      },
      "identifier_type": "ukey",
      "identifier_number": "123456ABCD",
      "lock": "first",
      "time": {
        "is_permanent": false,
        "from": 1540819272,
        "to": 1540819272
      },
      "passes": {
        "is_permanent": false,
        "max_passes": 3
      },
      "apartment": {},
      "time_profiles": {
        "count": 4,
        "uid_items": [
          11,
          13,
          23,
          42
        ]
      }
    },
    {
      "identifier_id": 3,
      "identifier_owner": {
        "name": "Sherlock Holmes",
        "type": "owner"
      },
      "identifier_type": "ukey",
      "identifier_number": "123456ABCD",
      "lock": "first",
      "time": {
        "is_permanent": false,
        "from": 1540819272,
        "to": 1540819272
      },
      "passes": {
        "is_permanent": false,
        "max_passes": 3
      },
      "apartment": {},
      "time_profiles": {
        "count": 4,
        "uid_items": [
          11,
          13,
          23,
          42
        ]
      }
    }
  ],
  "list_option": {
    "pagination": {
      "total_items": 18,
      "items_limit": 10,
      "total_pages": 2,
      "current_page": 1
    },
    "sort": {
      "field": "name",
      "asc": true,
      "available_fields": [
        "name"
      ]
    }
  }
}

{
  "list_items": [
    {
      "identifier_id": 1,
      "identifier_owner": {
        "name": "Sherlock Holmes",
        "type": "owner"
      },
      "identifier_type": "ukey",
      "identifier_number": "123456ABCD",
      "lock": "first",
      "time": {
        "is_permanent": false,
        "from": 1540819272,
        "to": 1540819272
      },
      "passes": {
        "is_permanent": false,
        "max_passes": 3
      },
      "apartment": {
        "uid": 4,
        "logical_address": {
          "building": 1,
          "unit": 2,
          "floor": 3,
          "room": 4
        }
      },
      "time_profiles": {
        "count": 4,
        "uid_items": [
          11,
          13,
          23,
          42
        ]
      }
    },
    {
      "identifier_id": 2,
      "identifier_owner": {
        "name": "Sherlock Holmes",
        "type": "owner"
      },
      "identifier_type": "card",
      "identifier_number": "123456",
      "lock": "first",
      "time": {
        "is_permanent": false,
        "from": 1540819272,
        "to": 1540819272
      },
      "passes": {
        "is_permanent": false,
        "max_passes": 3
      },
      "apartment": {},
      "time_profiles": {
        "count": 4,
        "uid_items": [
          11,
          13,
          23,
          42
        ]
      }
    },
    {
      "identifier_id": 3,
      "identifier_owner": {
        "name": "Sherlock Holmes",
        "type": "owner"
      },
      "identifier_type": "ukey",
      "identifier_number": "123456ABCD",
      "lock": "first",
      "time": {
        "is_permanent": false,
        "from": 1540819272,
        "to": 1540819272
      },
      "passes": {
        "is_permanent": false,
        "max_passes": 3
      },
      "apartment": {},
      "time_profiles": {
        "count": 4,
        "uid_items": [
          11,
          13,
          23,
          42
        ]
      }
    }
  ],
  "list_option": {
    "pagination": {
      "total_items": 18,
      "items_limit": 10,
      "total_pages": 2,
      "current_page": 1
    },
    "sort": {
      "field": "name",
      "asc": true,
      "available_fields": [
        "identifier_number",
        "name"
      ]
    }
  }
}

• Wrong pagination limit
• Wrong pagintation page number
• Wrong sort field
• Wrong sort type
• Wrong filter options

Log In

Loading...