Developer Portal
Connector Guides
API ReferenceConsole

Kastle

KastleLogo

Kastle provides devices and software for security & access control. Through this connector, you can normalize your Kastle Oasis and Event Stream data.

Use Cases

Potential use cases include:

  • Build occupancy management apps utilizing access control data
  • Develop alerts to identify spaces that are over capacity based on how many people swiped into a particular space
  • Build tailgating security breach alerts based on a combination of Kastle access data and live occupancy data from other systems

Configuration

The Kastle Connector uses both Oasis Connect and Event Stream Username and Password for authorization, however you will also need both Owner GUIDs as well, which are currently only supplied by Kastle support. They can be reached via [email protected].

CredentialDescription
Oasis Connect UsernameThe Oasis Connect username provided by Kastle
Oasis Connect PasswordThe Oasis Connect password provided by Kastle
Event Stream UsernameThe Event Stream username provided by Kastle
Event Stream PasswordThe Event Stream password provided by Kastle
Event Stream Owner GUIDThe Event Stream Owner GUID provided by Kastle
Oasis Connect Owner GUIDThe Oasis Connect Owner GUID provided by Kastle

Mapped Concepts

Connector ConceptMapped Type
BuildingMappingBuilding
Card ReaderAccess_Card_Reader
Data streamAccess_Activity_Status

Sample Code

Here's an example showing how to retrieve when an access card reader registered a swipe during a specific window of time:

Request Response
Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  things(filter: {id: {eq: "THG46M9E7eggcTpXW3ZEw3w7k"}}) {
    id
    name
    exactType
    points {
      id
      name
      exactType
      series(startTime: "2023-05-20T10:00:00.000", endTime: "2023-05-25T00:00:00.000") {
        timestamp
        value {
          float64Value
        }
      }
    }
  }
}