Acesso à API

Visão geral

A OpenAPI do Data Service permite que você gerencie os recursos do UiPath Data Service de um aplicativo externo de sua escolha, permitindo que você autorize o aplicativo externo sem compartilhar qualquer credencial por meio da estrutura de autorização OAuth 2.0.

Learn how to register the external application in UiPath Automation Suite.

Permissões de API

Para usar a OpenAPI do Data Service, você precisa conceder permissões de API ao aplicativo externo. Essas permissões de API são conhecidas como escopos, e há três tipos para o Data Service:

• DataService.Schema.Read - esse Escopo do Usuário permite que seu aplicativo externo leia o esquema do Data Service do seu tenant, e depende das permissões do usuário.
• DataService.Data.Read — esse Escopo do Usuário permite que seu aplicativo externo leia os dados do Data Service do seu tenant, e depende das permissões do usuário.
• DataService.Data.Write — esse Escopo do Usuário permite que seu aplicativo externo edite os dados do Data Service do seu tenant excluindo, atualizando ou criando novos dados, e depende das permissões do usuário.

Learn more about the user roles and permissions in Data Service.

Baixar a especificação do OpenAPI

Com seu aplicativo externo e o conjunto de permissões do usuário definido, é hora de baixar a especificação da OpenAPI dos dados do Data Service do seu tenant. Faça isso navegando até o menu superior direito na guia Data Service do tenant > Acesso de API > Baixar arquivo da OpenAPI (JSON).

This will get you the OpenAPI 3.0 specifications of your tenant's Data Service entities, in JSON format. Clicking **Copy OpenAPI link** copies the API endpoint that generates the tenant's Data Service OpenAPI specification.

Autorizando as chamadas de API

Autorize seu aplicativo externo para usar a OpenAPI do Data Service criando um token de acesso para seu aplicativo externo. Use o ID do Aplicativo e Segredo do Aplicativo que foram gerados no registro do aplicativo externo. O método de autorização depende do tipo do aplicativo (confidencial ou não confidencial).

Saiba mais sobre os métodos de autorização para apps externos.

Pontos de extremidade da API

OAuth2.0 authorization framework helps you generate a access token that allows your external application to make REST API calls to Data Service endpoints, for a limited time (one hour). To continue calling the APIs you need to generate a new access token or request a refresh token.

Um endpoint da API do Data Service tem a seguinte sintaxe:

• Método HTTP + BaseURL + A categoria do recurso + A entidade do Data Service + A operação + Variáveis de caminho e parâmetros de consulta

  

  Importante:

  In the Automation Suite-deployed Data Service, each active connection can have only one active file upload API call.

  Para evitar essa limitação da API, certifique-se de passar o cabeçalho Connection: close em sua solicitação.

  Exemplo de entidade do Data Service

  Para descrever cada corpo de solicitação/resposta da API, usamos os campos de entidade das Olimpíadas criados no Data Service. Embora estejamos documentando o ponto de extremidade genérico, como Get Entity Records, o seu ponto de extremidade deve conter o nome exato da sua entidade (por exemplo, Get Olympics Records). Os corpos de resposta e solicitação incluem todos os campos da sua entidade, replicando a sua estrutura.

  

  Além disso, vamos mergulhar em cada ponto de extremidade para descobrir como você pode usá-lo da melhor forma.