UiPath Documentation
orchestrator
2025.10
true

Guia da API do Orchestrator

Última atualização 5 de mai de 2026

Obter conta de robô específica

Retorna informações sobre uma conta de Robot, com base na ID da organização e da conta de Robot.

Ponto de Extremidade da API

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

Escopos

Requer os seguintes escopos:

  • PM.RobotAccount
  • PM.RobotAccount.Read

Cabeçalhos de solicitação.

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'
--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'
Observação:

Para obter o {access_token}, certifique-se de se autenticar por meio de um dos métodos descritos aqui.

Parâmetros do caminho

Parâmetro do caminhoTipo de dadosDescription
partitionGlobalId (obrigatório)StringA ID da organização que contém o grupo desejado.
robotAccountID (obrigatório)StringO ID do grupo a ser excluído.

Resposta

200 OK

As informações da conta de Robot especificada são retornadas, como nome, horário de criação e as IDs dos grupos dos quais a conta faz parte.

Exemplo de solicitação

Digamos que você reuniu todas as informações necessárias para criar a chamada de API.

  • Seu {baseURL} é: https://{yourDomain}/identity
  • Seu {access_token} é: 1234 (para considerações de comprimento).
  • O {partitionGlobalId} é: 3fa85f64-5717-4562-b3fc-2c963f66afa6
  • O {robotAccountID} é: 33-ab

A chamada deve ser semelhante ao seguinte exemplo (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'

Aqui está o body da resposta de uma chamada bem-sucedida:

{
    "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"
    ]
}
  • Ponto de Extremidade da API
  • Escopos
  • Cabeçalhos de solicitação.
  • Parâmetros do caminho
  • Resposta
  • 200 OK
  • Exemplo de solicitação

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte

Quer aprender? Academia UiPath

Tem perguntas? Fórum do UiPath

Fique por dentro das novidades