Nesta dica você aprenderá a usar o Alteryx para enriquecer seus dados com informações externas, obtidas através de APIs.
Uma API é um conjunto de rotinas e padrões de programação para acesso a um aplicativo de software ou plataforma baseado na Web. A sigla API refere-se ao termo em inglês “Application Programming Interface” que significa em tradução para o português “Interface de Programação de Aplicativos.
Existem inúmeras APIs disponíveis na Internet, que podem fornecer informações complementares valiosas para seu conjunto de dados
Introdução
Suponha que você tenha uma base de dados de compras realizadas no exterior. As compras foram feitas em dólar, e você precisa saber quanto essas despesas representam em Real. Você sabe a data da compra, mas não tem acesso ao histórico de cotação. Sua base de dados tem o seguinte formato:
---------------------------------- Data da Compra Moeda Valor ---------------------------------- 2020-04-01 USD 500.00 2020-04-02 USD 200.00 2020-04-03 USD 300.00 ----------------------------------
Felizmente existe na internet inúmeras APIs que fornecem esta informação, e usaremos uma delas para complementar nosso conjunto de dados.
A API utilizada nesta dica é a economia.awesomeapi.com.br. Ela possui diversas configurações, e usaremos os parâmetros que retornam a cotação do Dólar em real em uma data especifica.
Passo 1: Insira a URL da API no seu Workflow
Utilize a ferramenta Text Input para inserir a chamada da API no seu fluxo de trabalho. Como a data da cotação é um parâmetro variável, referencie-a por uma String que facilite sua substituição.
Passo 2: Prepare os Parâmetros da API
A API que utilizaremos recebe a data da cotação em um formato específico, YYYYMMDD. Crie um novo campo contendo a data da compra como uma String, seguindo este formato.
Passo 3: Inclua a chamada da API no fluxo principal
Use a ferramenta Append Fields para incluir o campo contendo a chamada da API no fluxo principal. Como a chamada está contida em apenas 1 linha, não haverá multiplicação de registros.
Passo 4: Personalize a chamada da API para cada registro
Use a ferramenta Formula para alterar a chamada da API, de forma que a data da cotação requisitada seja a data da compra de cada registro.
Passo 5: Chame a API
Use a ferramenta Download para realizar a chamada à API. A URL da API será o campo personalizado no passo anterior. Este passo vai realizar tantas chamadas quanto forem os registros da entrada.
Como a API não requer configurações adicionais, como autenticação, podemos prosseguir.
Passo 6: Tratamento do Retorno
A API que estamos usando retorna um Json como resposta. Use a ferramenta JSON Parse para transformar esta saída em campos que podem ser manipulados.
Note que a ferramenta gera 1 linha para cada campo do Json. Não se preocupe, vamos nos livrar das linhas extras no passo seguinte
Passo 7: Elimine os registros desnecessários
Olhando as informações disponíveis, podemos ver que a informação da cotação do dólar está no campo 0.bid. Use a ferramenta Filter para manter apenas estes registros.
O número de registros deve retornar ao número inicial do seu conjunto de dados.
Passo 8: Calcule o valor em reais
De posse da cotação do dia e do valor em dólar, use a ferramenta Formula para calcular o valor da compra em reais.
Passo 9: Retire os campos desnecessários e analise o resultado
Por último, use a ferramenta Select para eliminar os campos indesejados e a ferramenta Browse para analisar o resultado final.
Pronto! Agora você sabe usar APIs para enriquecer seus dados!
Gostou dessa dica? Quer aprender mais? Visite nossa página de treinamento e aproveite todo o potencial do Alteryx.