Criação do primeiro conector

Esta seção explica como criar um conector usando o Connector Builder e usá-lo em uma automação. O exemplo abrange a criação de um conector por meio de um processo manual, portanto, abordamos automaticamente pontos que, de outra forma, normalmente seriam ignorados.

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

Observação:

Você também pode verificar a seção Criação de seu conector a partir de uma definição da API . Isso explica como importar uma definição do Swagger e permitir que o Construtor de Conector conclua a maior parte do trabalho para você.

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. Vá para 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

Navegue até o Integration Service e selecione Construir seu conector.

Vamos começar com Um conector em branco. Se você tiver alguma forma de definição de API em mãos (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ê.

1. 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 compatíveis, mas recomendamos usar um SVG quadrado.

2. 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 faz referência a que qualquer chamada de API para sua plataforma requer que você envie sua chave de API nos cabeçalhos ou como um parâmetro de consulta. Para fazer isso, 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 formulário a seguir, onde <your_token> é a chave de API:

   Authorization: Bearer <your_token>

3. No Construtor de Conector, navegue até Configurações e selecione a aba 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. Isso nos permite executar algumas das chamadas de API de ações mais antigas.

   

4. Em seguida, acesse a aba 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 Polygon se refere a uma chave de API, mas, como ela deve ser enviada como Autorização: Portador <your\_token>, ela está, na verdade, mais próxima de um token de estilo OAuth. Portanto, o 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 Polygon e defina o Valor como: Bearer <your_key>.

6. Defina o campo Perguntar ao usuário como Não, para que não seja solicitada a chave dos usuários ao criar uma conexão com esse conector. Isso ocorre porque não vamos compartilhar esse conector além de nosso tenant. Se, no entanto, você quiser compartilhar o conector além do tenant, não adicione sua própria chave. Defina Perguntar ao usuário como Sim, para que outros usuários sejam solicitados a se inscrever no serviço do Polygon. Os tipos de autenticação pré-configurados no Construtor de Conector cuidam da maior parte do trabalho para você. Por exemplo, o Token de acesso pessoal envia automaticamente Autorização: Portador <your\_token> como um cabeçalho de autenticação, em vez de você ter que criar essa configuração por conta própria.

   

7. Configure uma conexão com a configuração mencionada 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 você tenha 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ário do Polygon.

   

2. Na janela Criar novo grupo de recursos , copie as informações do endpoint dos documentos do Polygon.

3. Defina o Caminho como /open-close/{stocksTicker}/{date}.

4. Na lista Selecionar métodos , habilite Get Record ( GETBYID), pois selecionamos um único objeto em vez de uma array 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 do seu recurso. Isso cria valores para os dois parâmetros do caminho. Podemos baseá-los no exemplo de uso na documentação do Polygon.

   

Publique o conector no catálogo

Você pode seguir algumas etapas extras para fazer com que os recursos e os parâmetros tenham uma aparência e se comportam melhor. Por exemplo, identifique que o parâmetro Date é do tipo DateTime e forneça a máscara como exemplo. Fornecer nomes de exibição faz com que seu conector apareça melhor dentro da atividade do Studio. A imagem a seguir mostra como configurar esses campos:

Como etapa final, selecione Publicar para publicar seu conector em seu tenant. O conector aparece na lista de conectores em destaque no seu tenant, e qualquer pessoa que esteja usando o mesmo tenant pode usar o conector Polygon.

Para obter mais informações, consulte a seção detalhada Publicando seu conector .

Usar o conector no UiPath Studio

Criar um conector personalizado 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árias do Slack. Como queremos receber mensagens diárias, a primeira atividade usada neste 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 diretamente a ação na qual está interessado, mas deve formatar a data para que seja a data do tempo de execução.
4. Em seguida, adicione uma atividade Slack Send Message to Channel para enviar essas informações para um canal. Se você quiser enviar as informações para si mesmo, use Send Message to User.

Observação:

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