Orchestrator API 指南

适用平台：

上次更新日期 2025年10月27日

获取特定机器人帐户

根据组织和机器人帐户 ID，返回有关机器人帐户的信息。

API 端点

GET https://{yourDomain}/identity/api/RobotAccount/{partitionGlobalId}/{robotAccountId}

作用域

需要以下作用域：

PM.RobotAccount
PM.RobotAccount.Read

请求标头

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

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

路径参数

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

响应

200 OK

已返回指定的机器人帐户信息，例如名称、创建时间和帐户所属的组 ID。

请求示例

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

Your {baseURL} is: https://{yourDomain}/identity
您的 {access_token} 为：1234（出于长度考虑）。
{partitionGlobalId} 为：3fa85f64-5717-4562-b3fc-2c963f66afa6
{robotAccountID} 为：33-ab

调用应类似于以下示例 (cURL)：

curl --location --request GET 'https://{yourDomain}/identity/api/RobotAccount/3fa85f64-5717-4562-b3fc-2c963f66afa6/33-ab' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'curl --location --request GET 'https://{yourDomain}/identity/api/RobotAccount/3fa85f64-5717-4562-b3fc-2c963f66afa6/33-ab' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'

以下是成功调用的响应正文：

{
    "id": "33-ab",
    "name": "Bot3",
    "displayName": "Bot3",
    "creationTime": "2021-10-19T14:25:01.6574988",
    "lastModificationTime": "2021-10-19T14:25:01.6574988",
    "groupIds": [
       "4d161738-7204", "ce684f6f-5af3"
    ]
}{
    "id": "33-ab",
    "name": "Bot3",
    "displayName": "Bot3",
    "creationTime": "2021-10-19T14:25:01.6574988",
    "lastModificationTime": "2021-10-19T14:25:01.6574988",
    "groupIds": [
       "4d161738-7204", "ce684f6f-5af3"
    ]
}