Devices
A device that has been connected to Seam
The device
object represents a device that has been connected to Seam.
device
Properties
device
PropertiesThe device
object has the following properties:
Property | Type | Description |
---|---|---|
| String (UUID) | Unique identifier for the device. |
| String | Type of the device. |
| Collection of capabilities that the device supports when connected to Seam. | |
| See Device Error Types. | Array of errors associated with the device. Each error object within the array contains two fields:
|
| See Device Warning Types. | Array of warnings associated with the device. Each warning object within the array contains two fields:
|
| See | Location information for the device. |
| See Device Manufacturers. | Manufacturer of the device. |
| Object | Properties of the device. |
| JSON object | Set of |
| String (UUID) | Unique identifier for the Seam workspace associated with the device. |
| Datetime | Date and time at which the device object was created. |
device.properties
Properties
device.properties
PropertiesProperty | Type | Description |
---|---|---|
| Boolean | Indicates whether the device is locked. |
| Boolean | Indicates whether the device is online. |
| Boolean | Indicates whether the door is open. |
| String | Manufacturer of the device. |
| Float | Battery level of the device.
(Deprecated) Use |
| Object | Manufacturer-specific metadata for the device, where |
| Array | Supported code lengths for the device. For example, |
| Boolean | Indicates whether it is currently possible to use online access codes for the device. |
| Boolean | Indicates whether it is currently possible to use offline access codes for the device. |
| Integer | Maximum number of codes that can exist on the device at one time. |
| Array | Constraints on access codes that can be set on the device for devices that support access codes. |
| String | Name of the device. |
| Object | Represents the current status of the battery charge level. Values are:
|
| Object | Information about the keypad battery for the device, if available. Includes a |
| String | Serial number for the device, if available. |
| String | Image URL for the device or placeholder image URL if a device-specific image is unavailable. |
location
Properties
location
PropertiesProperty | Type | Description |
---|---|---|
| String | Name of the device location. |
| String | Time zone of the device location, as a name from the IANA time zone database. |
capabilities_supported
Values
capabilities_supported
ValuesCapability | Description |
---|---|
| If present, you can set access codes on the device. |
| If present, you can look at the |
| If present, you can introspect some parameters related to the health of the device. |
| If present, you can lock and unlock the device. |
| If present, the device can issue noise alerts when noise thresholds are exceeded. |
| If present, the device can regulate the temperature of a system so that the temperature of the system is maintained near a desired set point temperature. |
Device Error Types
Errors are returned in a list. For example:
Generic Errors
Seam recommends adding error handling logic to you app for each generic error in this table. Seam may add more generic errors in the future, so your app should include a fallback case if it encounters an unknown generic error code.
Error Type | Description |
---|---|
| Device is disconnected. |
| Device has been removed from the connected account. Seam can no longer sync with this device. |
| The hub that the device is connected to is offline. Seam is unable to sync updates to this device. |
Specific Errors
When Seam is able to provide more specific information beyond one of the generic errors, one or more errors from the list of specific errors may appear. This gives your app the option to display additional context or suggest provider specific resolutions.
If the connected account associated with a device has an error, it is attached to the device alongside any other device errors. Treat these errors as specific errors. See Connected Account Error Types.
Error Type | Description |
---|---|
| Missing device credentials. Create a new Connect Webview to provide the credentials. |
| The lock is not paired with a gateway. Seam cannot unlock or program access codes on the lock. Add a gateway to enable support. |
Device Warning Types
Warnings are returned in a list. For example:
Warning Type | Description |
---|---|
| Device has a flaky connection to the internet. |
| We detected that another third-party service (for example, Operto) is being used to manage this device. This situation may cause access codes that Seam sets to fail because the third-party service is making modifications to Seam codes. |
| Lock is in office mode. Access codes will not unlock doors. You can disable office mode in the Salto dashboard. |
| Lock is in privacy mode. Access Codes will not unlock doors. You can disable privacy mode by pressing the back of the lock. |
| Turn on the remote unlock feature in the lock settings to enable unlocks. This feature must be turned on from the mobile app while near the door lock. |
Device Manufacturers
On some account types, Seam provides additional information about the manufacturer of the door lock. Where the device is being connected through a smart hub, the manufacturer of the door lock might be different from that of the smart hub.
Seam might return the following manufacturers:
august
keywe
kwikset
lockly
philia
samsung
schlage
yale
unknown
Device Providers
Seam maintains a list of device providers that you can access using the List Device Providers endpoint.
The Device Provider object includes the following information:
Property | Type | Description |
---|---|---|
| String | Name of the device provider. For example: |
| String | Formatted version of the For example: |
| String | Image URL for the provider logo. |
| Array | Array of associated categories for the provider. Supported categories:
|
The following example shows a device provider object:
Access Code Constraints
Each constraint in the code_constraints
array is an object with at least the constraint_type
property. The constraint_type
property can be one of the following:
Constraint Type | Description |
---|---|
|
|
| The PIN code cannot start with the sequence of digits |
| No more than 3 digits in a row can be consecutive or the same in the PIN code. |
| A PIN code cannot be specified. It must be left empty, and one will be generated by the lock provider. |
| If a PIN code is specified, it must match an existing set of PIN codes used in the account. For example, the PIN code matches the code assigned to a user in the system. |
| For time-bound codes, the start date has to be in the future. |
| The name of the code has some restrictions on length. When the |
device
Methods
device
MethodsYou can perform the following actions on device
objects:
Last updated