Skip to content

Commit 2591236

Browse files
DebbieAtSeamgitbook-bot
authored andcommitted
GITBOOK-586: Move info. from API ref devices page to conceptual section
1 parent 18b10ed commit 2591236

File tree

55 files changed

+278
-233
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

55 files changed

+278
-233
lines changed
-243 KB
Loading
17.4 KB
Loading
-160 KB
Loading

docs/SUMMARY.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,10 @@
3030
* [Managed and Unmanaged Devices](core-concepts/devices/managed-and-unmanaged-devices.md)
3131
* [Adding Custom Metadata to a Device](core-concepts/devices/adding-custom-metadata-to-a-device.md)
3232
* [Filtering Devices by Custom Metadata](core-concepts/devices/filtering-devices-by-custom-metadata.md)
33+
* [Handling Device Errors](core-concepts/devices/handling-device-errors.md)
3334
* [Testing Your App Against Device Disconnection and Removal](core-concepts/devices/testing-your-app-against-device-disconnection-and-removal.md)
35+
* [Providers](core-concepts/providers/README.md)
36+
* [Provider Metadata](core-concepts/providers/device-provider-metadata.md)
3437
* [Connected Accounts](core-concepts/connected-accounts/README.md)
3538
* [Adding Custom Metadata to a Connected Account](core-concepts/connected-accounts/adding-custom-metadata-to-a-connected-account.md)
3639
* [Filtering Connected Accounts by Custom Metadata](core-concepts/connected-accounts/filtering-connected-accounts-by-custom-metadata.md)
@@ -43,7 +46,8 @@
4346
* [🔒 Smart Locks](products/smart-locks/README.md)
4447
* [Locking and Unlocking Smart Locks](products/smart-locks/lock-and-unlock.md)
4548
* [Creating and Managing Smart Lock Access Codes](products/smart-locks/access-codes/README.md)
46-
* [Creating Access Codes](products/smart-locks/access-codes/creating-access-codes.md)
49+
* [Creating Access Codes](capability-guides/smart-locks/access-codes/creating-access-codes/README.md)
50+
* [Understanding Code Constraints](capability-guides/smart-locks/access-codes/creating-access-codes/understanding-code-constraints.md)
4751
* [Retrieving Access Codes](products/smart-locks/access-codes/retrieving-access-codes.md)
4852
* [Modifying Access Codes](products/smart-locks/access-codes/modifying-access-codes.md)
4953
* [Deleting Access Codes](products/smart-locks/access-codes/deleting-access-codes.md)
@@ -150,7 +154,6 @@
150154
* [Devices](api-clients/devices/README.md)
151155
* [List Devices](api-clients/devices/list.md)
152156
* [List Device Providers](api-clients/devices/list_device_providers.md)
153-
* [Device Provider Metadata](reference/device-provider-metadata.md)
154157
* [Get a Device](api-clients/devices/get.md)
155158
* [Update a Device](api-clients/devices/update.md)
156159
* [Unmanaged Devices](api-clients/devices/unmanaged/README.md)

docs/api-clients/connect_webviews/README.md

Lines changed: 0 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -34,62 +34,6 @@ To enable a user to connect their device account to Seam through your app, you m
3434
| **`authorized_at`** | String | Date and time at which the user authorized (through the Connect Webview) the management of their devices |
3535
| **`workspace_id`** | String (UUID) | ID of the [workspace](../../core-concepts/workspaces/) that contains the Connect Webview |
3636

37-
### Provider Category Keys
38-
39-
When you [create a Connect Webview](create.md), specify the desired provider category key in the `provider_category` parameter. Alternately, to specify a list of providers explicitly, use the `accepted_providers` parameter with a list of [device provider keys](./#device-provider-keys).
40-
41-
| key | Description |
42-
| --------------------- | ------------------------------------------------------------------ |
43-
| `stable` | Only returns provider integrations marked as stable. |
44-
| `consumer_smartlocks` | Only returns provider integrations marked as consumer smart locks. |
45-
| `thermostats` | Only returns provider integrations marked as thermostats. |
46-
| `noise_sensors` | Only returns provider integrations marked as noise sensors. |
47-
48-
{% hint style="info" %}
49-
To list all providers within a category, use the [List Device Providers](../devices/list_device_providers.md) method with the desired `provider_category` filter.
50-
{% endhint %}
51-
52-
### Device Provider Keys
53-
54-
To list all provider keys, use the [List Device Providers](../devices/list_device_providers.md) method with no filters.
55-
56-
| Provider Name | Device Provider Key |
57-
| -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
58-
| [2N](../../device-guides/2n-intercom-systems.md) | `my_2n` |
59-
| [4SUITES](../../device-and-system-integration-guides/4suites-locks/) | `four_suites` |
60-
| [Akiles](../../device-and-system-integration-guides/akiles-locks/) | `akiles` |
61-
| [Akuvox](https://akuvox.com/) | `akuvox` |
62-
| [ASSA ABLOY Credential Service](../../device-and-system-integration-guides/assa-abloy-credential-services-credential-manager.md) | `assa_abloy_credential_service` |
63-
| [ASSA ABLOY Visionline Access Control System](../../device-and-system-integration-guides/assa-abloy-visionline-access-control-system/) | `visionline` |
64-
| [August Home](../../device-guides/august-locks.md) | `august` |
65-
| [Avigilon Alta](../../device-guides/avigilon-alta-access-system.md) | `avigilon_alta` |
66-
| [Brivo](../../device-guides/brivo-access.md) | `brivo` |
67-
| [ControlByWeb](../../device-guides/get-started-with-controlbyweb-devices.md) | `controlbyweb` |
68-
| [DoorKing](https://www.doorking.com/) | `doorking` |
69-
| [dormakaba Oracode](../../device-guides/dormakaba-oracode-locks.md) | `dormakaba_oracode` |
70-
| [ecobee](../../device-guides/ecobee-thermostats.md) | `ecobee` |
71-
| [Genie Aladdin Connect](https://www.geniecompany.com/aladdin-connect-by-genie) | `genie` |
72-
| [Honeywell Resideo](../../device-and-system-integration-guides/honeywell-thermostats/) | `honeywell_resideo` |
73-
| [igloohome](../../device-guides/igloohome-locks.md) | `igloohome` |
74-
| [Kwikset](../../device-guides/kwikset-locks.md) | `kwikset` |
75-
| [Latch](../../device-and-system-integration-guides/latch-access-control-system/) | `latch` |
76-
| [Linear](https://linear-solutions.com/) | `linear` |
77-
| [Lockly](../../device-and-system-integration-guides/lockly-locks/) | `lockly` |
78-
| [Minut](../../device-guides/minut-sensors.md) | `minut` |
79-
| [Nest](../../device-guides/google-nest-thermostats/) | `google_nest` |
80-
| [NoiseAware](../../device-guides/noiseaware-sensors.md) | `noiseaware` |
81-
| [Nuki](../../device-guides/nuki-locks.md) | `nuki` |
82-
| [PTI Storlogix Cloud](../../device-guides/pti-storlogix-cloud.md) | `pti` |
83-
| [Salto KS Access System](../../device-and-system-integration-guides/salto-ks-access-control-system/) | `salto_ks` |
84-
| [Salto KS Locks](../../device-guides/salto-locks.md) | `salto` |
85-
| [Salto ProAccess Space Access System](../../device-and-system-integration-guides/salto-proaccess-space-access-system/) | `salto_space` |
86-
| [Schlage](https://www.schlage.com/en/home/products/products-smart-locks.html) | `schlage` |
87-
| [SmartThings](https://www.smartthings.com/) | `smartthings` |
88-
| [Tedee](../../device-and-system-integration-guides/tedee-locks/) | `tedee` |
89-
| [TTLock](../../device-guides/ttlock-locks.md) | `ttlock` |
90-
| [Wyze](../../device-guides/wyze-locks.md) | `wyze` |
91-
| [Yale](../../device-guides/yale-locks.md) | `yale` |
92-
9337
## `connect_webview` Methods
9438

9539
You can perform the following actions on `connect_webview` objects:

docs/api-clients/devices/README.md

Lines changed: 1 addition & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -92,7 +92,7 @@ Seam recommends adding error handling logic to you app for each generic error in
9292
When Seam is able to provide more specific information beyond one of the [generic errors](./#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.
9393

9494
{% hint style="info" %}
95-
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](../connected_accounts/#connected-account-error-types).
95+
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.
9696
{% endhint %}
9797

9898
| Error Type | Description |
@@ -122,43 +122,6 @@ Warnings are returned in a list. For example:
122122
| `salto_privacy_mode` | Lock is in privacy mode. Access Codes will not unlock doors. You can disable privacy mode by pressing the back of the lock. |
123123
| `ttlock_lock_gateway_unlocking_not_enabled` | 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. |
124124

125-
## Device Manufacturers
126-
127-
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.
128-
129-
## Device Providers
130-
131-
Seam maintains a list of device providers that you can access using the [List Device Providers](list_device_providers.md) endpoint.
132-
133-
The `device_provider` object includes the following information:
134-
135-
<table><thead><tr><th width="273">Property</th><th width="101.33333333333331">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>device_provider_name</code></td><td>String</td><td><p>Name of the device provider.</p><p>For example: <code>august</code></p></td></tr><tr><td><code>display_name</code></td><td>String</td><td><p>Formatted version of the <code>device_provider_name</code>.</p><p>For example: <code>August</code></p></td></tr><tr><td><code>image_url</code></td><td>String</td><td>Image URL for the provider logo.</td></tr><tr><td><code>provider_categories</code></td><td>Array</td><td><p>Array of associated categories for the provider.</p><p>Supported categories:</p><ul><li><code>stable</code></li><li><code>consumer_smartlocks</code></li><li><code>thermostats</code></li><li><code>noise_sensors</code></li></ul></td></tr><tr><td><code>can_remotely_unlock</code></td><td>Boolean</td><td>Indicates whether at least one supported device from the provider can perform a <a href="../../products/smart-locks/lock-and-unlock.md">remote unlock operation</a>. See <a href="../../capability-guides/device-and-system-capabilities.md#capability-flags">Capability Flags</a>.</td></tr><tr><td><code>can_remotely_lock</code></td><td>Boolean</td><td>Indicates whether at least one supported device from the provider can perform a <a href="../../products/smart-locks/lock-and-unlock.md">remote lock operation</a>. See <a href="../../capability-guides/device-and-system-capabilities.md#capability-flags">Capability Flags</a>.</td></tr><tr><td><code>can_program_online_access_codes</code></td><td>Boolean</td><td>Indicates whether at least one supported device from the provider can <a href="../../products/smart-locks/access-codes/">program online access codes</a>. See <a href="../../capability-guides/device-and-system-capabilities.md#capability-flags">Capability Flags</a>.</td></tr><tr><td><code>can_program_offline_access_codes</code></td><td>Boolean</td><td>Indicates whether at least one supported device from the provider can <a href="../../products/smart-locks/access-codes/offline-access-codes.md">program offline access codes</a>. See <a href="../../capability-guides/device-and-system-capabilities.md#capability-flags">Capability Flags</a>.</td></tr></tbody></table>
136-
137-
The following example shows a `device_provider` object:
138-
139-
```json
140-
{
141-
"device_provider_name": "august",
142-
"display_name": "August",
143-
"image_url": "https://connect.getseam.com/_next/image?url=https://connect.getseam.com/assets/images/logos/august_logo_square.png&q=75&w=128",
144-
"provider_categories": [
145-
"stable",
146-
"consumer_smartlocks"
147-
],
148-
"can_remotely_lock": true,
149-
"can_remotely_unlock": true,
150-
"can_program_online_access_codes": true
151-
}
152-
```
153-
154-
## Access Code Constraints
155-
156-
Each constraint in the `code_constraints` array contains objects with the `constraint_type` property. Depending on the constraint type, there may also be additional properties. Note that some constraints are [manufacturer](broken-reference/) or [device](broken-reference/)-specific.
157-
158-
The `constraint_type` property can be one of the following enum values:
159-
160-
<table><thead><tr><th width="338">Constraint Type</th><th>Description</th></tr></thead><tbody><tr><td><code>no_zeros</code></td><td><code>0</code>s cannot be used as digits in the PIN code.</td></tr><tr><td><code>cannot_start_with_12</code></td><td>The PIN code cannot start with the sequence of digits <code>12</code>.</td></tr><tr><td><code>no_triple_consecutive_ints</code></td><td>No more than three digits in a row can be consecutive or the same in the PIN code.</td></tr><tr><td><code>cannot_specify_pin_code</code></td><td>You cannot specify a PIN code. You must leave the code empty, and the lock provider generates a PIN code.</td></tr><tr><td><code>pin_code_matches_existing_set</code></td><td><p>If you specify a PIN code, it must match an existing set of PIN codes used in the account.</p><p>For example, the PIN code could match the code assigned to a user in the system.</p></td></tr><tr><td><code>start_date_in_future</code></td><td>For time-bound codes, the start date must be in the future.</td></tr><tr><td><code>no_ascending_or_descending_sequence</code></td><td>The PIN code cannot consist of a sequence of consecutive digits.</td></tr><tr><td><code>at_least_three_unique_digits</code></td><td>The PIN must contain at least three unique digits.</td></tr><tr><td><code>cannot_contain_089</code></td><td><p>The PIN code cannot contain the digits <code>0</code>, <code>8</code>, or <code>9</code>.</p><p>For example, this restriction could apply to a cylinder lock that only includes the digits <code>1</code> to <code>7</code>.</p></td></tr><tr><td><code>cannot_contain_0789</code></td><td><p>The PIN code cannot contain the digits <code>0</code>, <code>7</code>, <code>8</code>, or <code>9</code>.</p><p>For example, this restriction could apply to a cylinder lock that only includes the digits <code>1</code> to <code>6</code>.</p></td></tr><tr><td><code>name_length</code></td><td><p>The name of the code has some restrictions on length.</p><p>When the <code>constraint_type</code> is <code>name_length</code>, the constraint object has one or two additional properties called <code>min_length</code> and <code>max_length</code> to specify the length constraints.</p></td></tr><tr><td><code>name_must_be_unique</code></td><td>The name of the code must be unique within the device.</td></tr></tbody></table>
161-
162125
## `device` Methods
163126

164127
You can perform the following actions on `device` objects:

docs/api-clients/events/README.md

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -166,9 +166,3 @@ In addition to the common event properties and common device event properties, t
166166
| [Get an Event](get.md) | Get data for an individual event |
167167

168168
***
169-
170-
## Testing Events
171-
172-
Use the Webhooks sandbox in the Seam Console to see the different payloads for each event and test them against your own endpoints!
173-
174-
<figure><img src="../../.gitbook/assets/testing-your-webhooks.png" alt=""><figcaption></figcaption></figure>

docs/api-clients/noise_sensors/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ Here, we can see the device has two thresholds- one during the night and one dur
4444
### Create Noise Thresholds
4545

4646
{% hint style="info" %}
47-
For a more in-depth guide to threshold creation, check out our guide here.
47+
For a more in-depth guide to threshold creation, check out our guide [here](../../products/noise-sensors/configure-noise-threshold-settings.md).
4848
{% endhint %}
4949

5050
If your device has no default thresholds, or you wish to create custom ones, you can create a noise threshold with the `Create Noise Threshold` endpoint. For example, you can create an endpoint like this:

0 commit comments

Comments
 (0)