[预览] 获取所有机器人帐户

根据组织 ID，返回组织中所有机器人帐户的列表。

API 端点

https://{yourDomain}/identity/api/Setting

作用域

需要以下作用域：

• PM.RobotAccount
• PM.RobotAccount.Read

请求标头

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'

注意：如要获取 {access_token}，请确保通过此处描述的其中一种方法进行身份验证。

路径参数

路径参数	数据类型	描述
partitionGlobalId (必填)	字符串	要检索其机器人帐户的组织 ID。

查询参数

查询参数	数据类型	描述
searchTerm (可选)	字符串	搜索机器人帐户时要使用的密钥。
top (可选)	Int32	显示前 N 个机器人帐户。
skip (可选)	Int32	跳过前 N 个机器人帐户。
sortBy (可选)	Int32	指定用于对审核条目进行排序的 DTO 属性。 例如 creationTime、id、name 等。
sortOrder (可选)	Int32	指定排序顺序。 例如，升序 (asc) 或降序 (desc)。

响应

200 OK

返回查询的机器人帐户。

请求示例

假设您收集了构建 API 调用所需的所有信息。

• 您的 {baseURL} 为：https://{yourDomain}/{organizationName}/{tenantName}/
• 您的 {access_token} 为：1234（出于长度考虑）。
• {partitionGlobalId} 为：magic-7

• 您需要设置以下查询参数：

  • searchTerm = bot
  • top = 2，显示前两个条目
  • skip = 2，跳过前两个条目
  • sortBy = name ，按条目名称对条目进行排序
  • sortOrder = asc，根据条目从旧到新的顺序排序

调用应如下所示 (cURL)：

curl --location --request GET 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/RobotAccount/magic-7?searchTerm=attended&top=2&skip=2&sortBy=name&sortOrder=asc' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'

以下是成功检索审核条目的响应正文：

{
    "totalCount": 3,
    "results": [
        {
            "id": "55-ab",
            "name": "Bot5",
            "displayName": "Bot5",
            "creationTime": "2021-10-19T18:05:17.3465735",
            "lastLoginTime": null,
            "groupIds": [
                "group1",
                "group2",
                "group3"
            ]
        },
        {
            "id": "66-cd",
            "name": "Bot6",
            "displayName": "Bot6",
            "creationTime": "2021-10-19T18:06:00.3088553",
            "lastLoginTime": null,
            "groupIds": [
                "group1",
                "group3"
            ]
        },
        {
            "id": "77-ef",
            "name": "Bot7",
            "displayName": "Bot7",
            "creationTime": "2021-10-19T18:05:31.4736281",
            "lastLoginTime": null,
            "groupIds": [
                "group2"
            ]
        }
    ]
}