You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/api/access_methods/README.md
+7-2Lines changed: 7 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -103,9 +103,9 @@ URL of the Instant Key for mobile key access methods.
103
103
104
104
---
105
105
106
-
**`is_card_encoding_required`***Boolean*
106
+
**`is_encoding_required`***Boolean*
107
107
108
-
Indicates whether card encoding is required for plastic card access methods.
108
+
Indicates whether encoding with an card encoder is required to issue or reissue the plastic card associated with the access method.
109
109
110
110
111
111
@@ -332,6 +332,11 @@ An access method was reissued due to an access grant update.
332
332
Delete an access method.
333
333
334
334
335
+
[**`/access_methods/encode`**](./encode.md)
336
+
337
+
Encodes an existing [credential](../../capability-guides/access-systems/managing-credentials.md) onto a plastic card placed on the specified [encoder](../../capability-guides/access-systems/working-with-card-encoders-and-scanners/README.md).
**Early Access Preview.** The access methods API is currently in Alpha. We're actively developing it and seeking early feedback at [[email protected]](mailto:[email protected]). Expect breaking changes as we refine the design.
4
+
{% endhint %}
5
+
6
+
-[Request Parameters](#request-parameters)
7
+
-[Response](#response)
8
+
9
+
Encodes an existing [credential](../../capability-guides/access-systems/managing-credentials.md) onto a plastic card placed on the specified [encoder](../../capability-guides/access-systems/working-with-card-encoders-and-scanners/README.md).
10
+
11
+
12
+
<details>
13
+
14
+
<summary>Authentication Methods</summary>
15
+
16
+
- API key
17
+
- Personal access token
18
+
<br>Must also include the `seam-workspace` header in the request.
19
+
20
+
To learn more, see [Authentication](https://docs.seam.co/latest/api/authentication).
21
+
</details>
22
+
23
+
## Request Parameters
24
+
25
+
**`access_method_id`***String* (Required)
26
+
27
+
ID of the `access_method` to encode onto a card.
28
+
29
+
---
30
+
31
+
**`acs_encoder_id`***String* (Required)
32
+
33
+
ID of the `acs_encoder` to use to encode the `acs_credential`.
Copy file name to clipboardExpand all lines: docs/api/acs/README.md
+22-33Lines changed: 22 additions & 33 deletions
Original file line number
Diff line number
Diff line change
@@ -6,86 +6,75 @@ description: Systems for managing and monitoring access to physical spaces
6
6
7
7
Access control systems centralize access authorization for buildings, which means that you can use a single system to grant users access to one or more entrances. An access control system manages the following elements:
8
8
9
-
* Who has access
10
-
* The entrances to which users have access
11
-
* The access schedule for each user and entrance
12
-
* The access mechanism—PIN codes, mobile keys, or plastic cards—for each access grant
9
+
- Who has access
10
+
- The entrances to which users have access
11
+
- The access schedule for each user and entrance
12
+
- The access mechanism—PIN codes, mobile keys, or plastic cards—for each access grant
13
13
14
14
To grant access using the Seam access control system API, use the following basic process:
15
15
16
16
1. Create `acs_user`s.
17
-
2. Configure access for these users.\
17
+
2. Configure access for these users.
18
18
For some access control systems, configure the allowed entrances and access schedule. For other systems, use `acs_access_group`s. For details, see the [system integration guide](../../device-and-system-integration-guides/overview.md#access-control-systems) for your access control system.
19
-
3. Create `acs_credential`s, which are the digital means of granting access to users, such as PIN codes, mobile keys, and plastic (RFID) cards.\
20
-
If you are developing a mobile app to provide access for your users, you can also use [Seam's iOS and Android SDKs](../../capability-guides/mobile-access/mobile-device-sdks/) that pair with the Seam API to create and manage mobile keys.
19
+
3. Create `acs_credential`s, which are the digital means of granting access to users, such as PIN codes, mobile keys, and plastic (RFID) cards.
20
+
If you are developing a mobile app to provide access for your users, you can also use [Seam's iOS and Android SDKs](../../capability-guides/mobile-access/mobile-device-sdks/README.md) that pair with the Seam API to create and manage mobile keys.
21
21
22
22
## Resources
23
23
24
24
The Access Control Systems (ACS) namespace contains the following resources:
Group that defines the entrances to which a set of users has access and, in some cases, the access schedule for these entrances and users.
29
28
30
29
Some access control systems use [access group](https://docs.seam.co/latest/capability-guides/access-systems/assigning-users-to-access-groups), which are sets of users, combined with sets of permissions. These permissions include both the set of areas or assets that the users can access and the schedule during which the users can access these areas or assets. Instead of assigning access rights individually to each access control system user, which can be time-consuming and error-prone, administrators can assign users to an access group, thereby ensuring that the users inherit all the permissions associated with the access group. Using access groups streamlines the process of managing large numbers of access control system users, especially in bigger organizations or complexes.
31
30
32
31
To learn whether your access control system supports access groups, see the corresponding [system integration guide](../../device-and-system-integration-guides/overview.md#access-control-systems).
Means by which an [access control system user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) gains access at an [entrance](../../capability-guides/access-systems/retrieving-entrance-details.md). The `acs_credential` object represents a [credential](../../capability-guides/access-systems/managing-credentials.md) that provides an ACS user access within an [access control system](https://docs.seam.co/latest/capability-guides/access-systems).
39
36
40
37
An access control system generally uses digital means of access to authorize a user trying to get through a specific entrance. Examples of credentials include plastic key cards, mobile keys, biometric identifiers, and PIN codes. The electronic nature of these credentials, as well as the fact that access is centralized, enables both the rapid provisioning and rescinding of access and the ability to compile access audit logs.
41
38
42
39
For each `acs_credential`, you define the access method. You can also specify additional properties, such as a PIN code, depending on the credential type.
Represents a hardware device that encodes [credential](../../capability-guides/access-systems/managing-credentials.md) data onto physical cards within an [access control system](https://docs.seam.co/latest/capability-guides/access-systems).
49
44
50
45
Some access control systems require credentials to be encoded onto plastic key cards using a card encoder. This process involves the following two key steps:
51
46
52
-
1. Credential creation\
47
+
1. Credential creation
53
48
Configure the access parameters for the credential.
54
-
2. Card encoding\
49
+
2. Card encoding
55
50
Write the credential data onto the card using a compatible card encoder.
56
51
57
52
Separately, the Seam API also supports card scanning, which enables you to scan and read the encoded data on a card. You can use this action to confirm consistency with access control system records or diagnose discrepancies if needed.
58
53
59
-
See [Working with Card Encoders and Scanners](../../capability-guides/access-systems/working-with-card-encoders-and-scanners/).
54
+
See [Working with Card Encoders and Scanners](../../capability-guides/access-systems/working-with-card-encoders-and-scanners/README.md).
60
55
61
56
To verify if your access control system requires a card encoder, see the corresponding [system integration guide](../../device-and-system-integration-guides/overview.md#access-control-systems).
Represents an [entrance](../../capability-guides/access-systems/retrieving-entrance-details.md) within an [access control system](https://docs.seam.co/latest/capability-guides/access-systems).
68
61
69
62
In an access control system, an entrance is a secured door, gate, zone, or other method of entry. You can list details for all the `acs_entrance` resources in your workspace or get these details for a specific `acs_entrance`. You can also list all entrances associated with a specific credential, and you can list all credentials associated with a specific entrance.
Represents an [access control system](https://docs.seam.co/latest/capability-guides/access-systems).
76
67
77
68
Within an `acs_system`, create [`acs_user`s](https://docs.seam.co/latest/api/acs/users#acs_user) and [`acs_credential`s](https://docs.seam.co/latest/api/acs/credentials#acs_credential) to grant access to the `acs_user`s.
78
69
79
70
For details about the resources associated with an access control system, see the [access control systems namespace](https://docs.seam.co/latest/api/acs).
80
71
81
-
***
82
-
83
-
### [`acs_user`](users/#acs_user)
84
-
72
+
---
73
+
### [`acs_user`](./users/README.md#acs_user)
85
74
Represents a [user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) in an [access system](https://docs.seam.co/latest/capability-guides/access-systems).
86
75
87
76
An access system user typically refers to an individual who requires access, like an employee or resident. Each user can possess multiple credentials that serve as their keys or identifiers for access. The type of credential can vary widely. For example, in the Salto system, a user can have a PIN code, a mobile app account, and a fob. In other platforms, it is not uncommon for a user to have more than one of the same credential type, such as multiple key cards. Additionally, these credentials can have a schedule or validity period.
88
77
89
78
For details about how to configure users in your access system, see the corresponding [system integration guide](../../device-and-system-integration-guides/overview.md#access-control-systems).
@@ -210,6 +213,15 @@ Access (PIN) code for the [credential](../../../capability-guides/access-systems
210
213
211
214
212
215
216
+
---
217
+
218
+
**`connected_account_id`***UUID*
219
+
220
+
ID of the [connected account](../../../capability-guides/access-systems/managing-credentials.md#connected-accounts) to which the [credential](../../../capability-guides/access-systems/managing-credentials.md) belongs.
0 commit comments