Criação do primeiro conector

Esta seção explica como criar um conector usando o Construtor de Conector e usá-lo em uma automação. O exemplo abrange a criação de um conector por meio de um processo manual, para que correspondamos e abordamos automaticamente pontos que, de outra forma, podem ser ignorados.

Você também pode ver Construir seu conector a partir de uma definição de API, onde você importa uma definição do Swagger e o Construtor de Conector conclui a maior parte do trabalho para você.

O fluxo de trabalho que estamos desenvolvendo é feito para receber mensagens diárias do Slack sobre os preços das ações que são de seu interesse. O Polygon.io fornece um conjunto de APIs gratuitas que recuperam informações de ações e podem ser usadas para nosso propósito. Eles têm um processo de inscrição rápido que, em troca, nos fornece uma chave de API para fazer as chamadas de API que precisarmos fazer.

Inscreva-se com o Polygon.io

A maioria dos aplicativos de fornecedores exige detalhes de autenticação na forma de nome de usuário e senha, aplicativo OAuth, chave de API, etc. Com o Polygon.io não é diferente. Ele fornece um registro gratuito para experimentar algumas de suas APIs.

1. Acesse Polygon.io e crie uma conta.
2. Abra seu Painel e selecione Chaves de API para visualizar sua chave.

Crie um conector no Construtor de Conector

Na Automation Cloud^TM, navegue até o Integration Service e selecione Criar seu conector.

Vamos começar com Um conector em branco. Se você tiver qualquer forma de definição de API disponível (Swagger, YAML etc.), pode selecionar Iniciar a partir da definição da API e deixar o Connector Builder fazer a maior parte do trabalho de configuração para você.

Baixe o ícone polygon.svg da web para adicionar o logotipo deles ao seu catálogo.

Observação: todos os tipos de imagem são suportados, mas recomendamos usar um SVG quadrado.

Adicione um nome e descrição para seu conector personalizado e, em seguida, selecione Criar.

Configure a autenticação e conecte-se

A documentação de Introdução do Polygon menciona que qualquer chamada de API para a plataforma deles requer que você envie sua chave de API nos cabeçalhos ou como um parâmetro de consulta. Para fazê-lo, você precisa adicioná-lo aos cabeçalhos, conforme explicado no exemplo a seguir:

1. Passe sua chave de API na string de consulta da seguinte maneira, onde <your_token> é a chave de API:

   https://api.polygon.io/v2/aggs/ticker/AAPL/range/1/day/2023-01-09/2023-01-09?apiKey=<your_token>

2. Como alternativa, você pode adicionar um cabeçalho de Autorização à solicitação com sua Chave de API como o token, no seguinte formato, onde <your_token> é a chave de API:

   Authorization: Bearer <your_token>

3. No Construtor de Conector, navegue até Configurações e selecione a guia API base . Defina a URL base como https://api.polygon.io.
   Observação: neste exemplo, não adicionamos a seção version "v2" ao URL base, pois isso nos permite executar algumas das chamadas de API de ações mais antigas.
   
   

   

   
   
4. Em seguida, acesse a guia Autenticação para selecionar seu tipo de autenticação preferido na lista suspensa. Para este exemplo, vamos selecionar Token de acesso pessoal (PAT).
   Observação:

   A documentação do polígono se refere a uma chave de API, mas, como ele deve ser enviado como Authorization: Bearer <your_token>, na verdade, ela está mais próxima de um token do estilo OAuth. Portanto, Token de acesso pessoal (PAT) é tecnicamente a melhor definição. Leia mais sobre os diferentes tipos de autenticação.

5. Copie sua chave de API do polígono e defina o Valor como: Bearer <your_key>.
6. Defina o campo Perguntar ao usuário como Não, de modo que não será solicitada a chave dos usuários ao criar uma conexão com esse conector. Isso ocorre porque não compartilharemos esse conector além do nosso tenant. Se, no entanto, você quiser compartilhar o conector além do tenant, não adicione sua própria chave, mas defina Perguntar ao usuário como Sim, para que os outros usuários sejam solicitados a assinar o serviço do polígono, por conta própria.

   Os tipos de autenticação pré-configurados no Connector Builder cuidam da maior parte do trabalho para você. Por exemplo, o Token de acesso pessoal envia automaticamente Authorization: Bearer <your_token> como um cabeçalho de autenticação, em vez de você ter que construir essa configuração por conta própria.

   
   

   

   
   
7. Estabeleça uma conexão com a configuração acima selecionando o botão Não conectado > Adicionar conexão . Observe como isso já funciona como qualquer outro conector do Integration Service. Selecione Conectar para que tenhamos uma conexão de teste para fazer chamadas de API.

Testar suas chamadas de API

Após estabelecer uma conexão com o software de terceiros, passam a realizar as chamadas de API reais.

1. Navegue até o painel do lado esquerdo para API > Criar novo grupo de recursos. O objetivo é receber uma notificação diária do Slack sobre o preço de abertura de uma determinada ação. O ponto de extremidade que vamos implementar agora é a API de abertura/fechamento diária do Polygon .
   
   

   

   
   
2. Na janela Criar novo grupo de recursos , copie as informações do ponto de extremidade dos documentos do polígono.
3. Defina o Caminho como /open-close/{stocksTicker}/{date}.
4. Na lista Selecionar métodos , habilite Obter registro ( GETBYID ), já que estamos selecionando um único objeto, em vez de uma matriz de objetos.
5. Forneça um nome de exibição, como Open - Close para ações. O Construtor de Conector converterá automaticamente as variáveis {x} em variáveis de caminho.
6. Selecione Criar para adicionar esse recurso.
   
   

   

   
   
   

   

   
   
7. Para testar se a configuração está funcionando, selecione o botão Enviar solicitação ao lado de seu recurso. Isso cria valores para os dois parâmetros do caminho. Podemos retirá-los do exemplo de uso nos documentos do Polygon.
   
   

   

   
   

Publicação do conector no catálogo

Você pode executar algumas etapas extras para fazer com que os recursos e parâmetros tenham uma aparência e se comportam melhor. Por exemplo, identifique que o parâmetro Data é do tipo DateTime e forneça a máscara como exemplo. Fornecer nomes de exibição faz com que seu conector seja exibido melhor na atividade do Studio. É possível ver um exemplo na seguinte captura de tela

Como etapa final, selecione Publicar para publicar seu conector em seu tenant. O conector aparece na lista de conectores apresentados em seu tenant, e qualquer pessoa que esteja usando o mesmo tenant pode ver e usar o conector polígono.

Usar o conector no UiPath Studio

Fazer com que um conector apareça no Integration Service só é relevante se você puder realmente usá-lo em um fluxo de trabalho.

Para testar seu conector personalizado em um fluxo de trabalho:

1. Abra o UiPath Studio e crie um novo projeto. Por exemplo, preços de ações diários do Slack. Como queremos receber mensagens diárias, a primeira atividade usada nesse fluxo de trabalho é um Time Trigger.
   
   

   

   
   
2. Depois, ao arrastar uma atividade Polygon para a tela, você será solicitado a se conectar ao Polygon.io com sua conta.
3. Depois que a conexão for estabelecida, configure a atividade Polygon para recuperar informações sobre ações da Apple (AAPL). Você pode codificar a ação na qual está interessado, mas deve formatar a data para que seja a data do tempo de execução.
4. Depois, adicione uma atividade Send Message to Channel do Slack para enviar essas informações para um canal. Se você quiser enviar as informações para si mesmo, use Enviar mensagem para o usuário.

Observação: a API do Polygon leva apenas uma ação por vez, mas você pode configurar o Studio para fazer várias chamadas através do conector e também notificar o preço de abertura das ações diárias da UiPath (PATH).

Seu fluxo deve ficar da seguinte forma: