IntegrationHub - Como criar um Spoke para buscar empresas listadas na Bolsa de Valores (Action) - Rest API

Passo 1 - Ative o plugin do IntegrationHub.

Passo 2 - Gere uma API Key no link abaixo.

https://www.alphavantage.co/

Endpoint utilizado neste tutorial

https://www.alphavantage.co/query?function=SYMBOL_SEARCH&keywords={PalavraChave}&apikey={SuaApiKey}

Passo 3 - Entre na tabela de properties [sys_properties.list] do ServiceNow e Crie 2 property.

1- Com a Base URL do endpoint que será utilizado.

2- Com a sua API Key.

Obs: Serão usados nos próximos passos dentro da Action.

**Coloque o API Key no value

Passo 4 - Abra o Flow Designer e crie uma nova Action.

*Coloque o mesmo nome, pois será utilizado no Script Include.

Criando o Spoke (Action):

Passo 1

• Crie um input [keyword] do tipo string.

Passo 2

• Clique em [Add a new Step] e adicione o Script Step.
• Crie uma variável output [apikey] do tipo string.
• Adicione o script: outputs.apikey = gs.getProperty("apiKeyStockExchange");

Passo 3

• Clique em [Add a new Step] e adicione o REST Step.

*IMPORTANTE: Só estará disponível se você seguiu o Passo 1 que era ativar o IntegrationHub.

[Durante cada etapa na criação da Action vá salvando a cada passo pra não correr o risco de perder o que já foi feito.]

Passo 4

• Escolha o tipo de connection conforme imagem abaixo.

Adicione a chamada da 2º property na [Base URL]  return gs.getProperty("endpointBaseURL");

• Adicione o Resource Path conforme o endpoint disponibilizado alguns passos acima.

Ex: BASE URLhttps://www.alphavantage.co/
(já está sendo chamado no passo acima)
Path - query?function=SYMBOL_SEARCH&keywords={code}&apikey={apiKey}
Replique o conteúdo da imagem abaixo.

• Adicione método do tipo GET.

• Para evitar possíveis erros adicione no Headers:

            Name: Content-Type | Value: application/json

Passo 5

• Crie as variáveis de output conforme a imagem baixo, e depois clique em [Exit Edit Mode]

• Clique, arraste e solte no value dos outputs criados.

*Não esqueça de salvar o último passo desenvolvido.

Passo 6

•  clique em [Test]

         Digite dentro da caixinha keyWord o código vale3 e clique em [Run Test].

• Após rodar clique no link gerado para analisar o response body.

            O Status HTTP desse endpoint utilizado sempre retorna 200, mas a diferença será dentro do response body.

Test de sucesso

Cenário com erro utilizando um valor incorreto