Acesso à API

Visão geral

A Open API do Data Fabric permite gerenciar recursos do UiPath^® Data Fabric a partir de um aplicativo externo de sua escolha e o faz permitindo que você autorize o aplicativo externo sem compartilhar nenhuma credencial por meio da estrutura de autorização Oauth 2.0.

Saiba como registrar o aplicativo externo na UiPath^® Automation Cloud.

Permissões de API

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

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

Saiba mais sobre as funções e permissões do usuário no Data Fabric.

Baixar a especificação do OpenAPI

Depois de definir as permissões para seu aplicativo externo e usuários, baixe a especificação da OpenAPI de seus dados do Data Fabric de tenant:

• Na página Data Fabric , selecione Acesso à API e, em seguida, selecione Baixar arquivo da OpenAPI (JSON).

Esta operação baixa as especificações da OpenAPI 3.0 de suas entidades do Data Fabric de tenant, no formato JSON.

Selecionar Copiar link da OpenAPI copia o endpoint da API que gera a especificação da OpenAPI do Data Fabric do tenant.

Autorizando as chamadas de API

Autorize seu aplicativo externo para usar a OpenAPI do Data Fabric 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 aplicativos externos.

Pontos de extremidade da API

A estrutura de autorização OAuth2.0 ajuda você a gerar um token de acesso que permite que seu aplicativo externo faça chamadas da API REST para pontos de extremidade do Data Fabric , por um tempo limitado (uma hora).

Para continuar chamando as APIs, você precisa gerar um novo token de acesso ou solicitar um token de atualização.

Um ponto de extremidade da API do Data Fabric tem a seguinte sintaxe:

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

  
  

  

  
  

  Exemplo de entidade do Data Fabric

  Para descrever cada corpo de solicitação/resposta da API, usamos os campos de entidade Olimpíadas criados no Data Fabric. 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 usar o guia da API do Data Fabric para mergulhar em cada ponto de extremidade e descobrir como você pode fazer bom uso dele.