Employee Identity (EIAM)
Get Application Account List
Interface
# Permissions
The Identity Management API is authorized at the application level. Before calling an interface, you need to set interface permissions for different applications. For details, please refer to API Permissions.
| Permission Code | Description |
|---|---|
| account_all | Read and write permissions for account management interfaces |
| account_read | Read permission for account management interfaces |
| all | Read and write permissions for all interfaces |
| read | Permission for all read interfaces |
# Request Specification
GET https://{your_domain}/api/v2/tenant/applications/{app_id}/accounts?account_type=&offset=0&limit=10
# Request Headers
| Parameter Name | Chinese Name | Required | Type | Description |
|---|---|---|---|---|
| Authorization | Authorization | Yes | String | Format: Bearer {access_token} |
| Content-Type | Content Type | Yes | String | Fixed value: application/json; charset=utf-8 |
# Request Example
None
# Request Parameters
| Parameter Name | Chinese Name | Required | Type | Description |
|---|---|---|---|---|
| app_id | Application ID | Yes | String | Target application id |
| account_type | Account Type | No | String | Fixed value: Basic Account (BASIC_ACCOUNT), Orphan Account (ORPHAN_ACCOUNT), Public Account (PUBLIC_ACCOUNT). Leave blank to query all. |
| offset | Page Offset | Yes | Int | Starting from page 0 |
| limit | Page Size | Yes | Int | Page size between 10-100 |
# Return Example
Success Example:
HTTP/1.1 200 OK
{
"total": 2,
"accounts": [
{
"account_type": "BASIC_ACCOUNT",
"extension": {},
"org_id": null,
"account_name": "zhangs",
"name": "zs",
"disabled": false,
"attr_manager_id": "20230309180237515-A43K-CD390B5C8"
"id": "20220414163425614-2FD6-CA9B208BE"
},
{
"account_type": "ORPHAN_ACCOUNT",
"extension": {},
"org_id": null,
"account_name": "example01",
"name": "cq04130006",
"disabled": false,
"attr_manager_id": "20230309171558023-84A4-ED5C390B8"
"id": "20220414103145123-C349-6B6D9C126"
}
]
}
Error Example:
HTTP/1.1 400 Bad Request
{
"error_code": " APP.ACCOUNT.0045",
"error_msg": "账号的账号类型错误"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
# Return Parameters
| Parameter Name | Chinese Name | Type | Description |
|---|---|---|---|
| total | Total Count | Int | |
| accounts | Application Account Collection | List | |
| -- id | Application Account ID | String | |
| --account_name | Application Account Name | String | |
| --name | Name | String | |
| --org_id | Application Organization ID | String | |
| --disabled | Disabled or Not | Boolean | |
| --account_type | Account Type | String | |
| --attr_manager_id | Direct Superior | String | Application Account ID |
| --extension | Extension Field | Object |
# Error Codes
| Status Code | Error Code | Error Message | Handling Measures |
|---|---|---|---|
| 400 | APP.ACCOUNT.0045 | The account type of the account is incorrect | Please check if the type of the application account is correct |
| The account type of the account is incorrect | |||
| 500 | COM.0002 | System error | System error |
| System error, please contact the administrator |
