Solicite sua primeira API no Atalhos
Para solicitar a primeira API, crie um URL que aponte para o “endpoint” da API com a qual deseja se comunicar e passe o URL à ação “Obter Conteúdo do URL”. Quando o atalho é executado, essa ação faz a solicitação de API.
Construa a solicitação de API
A ponta do Dark Sky’s Forecast requer que uma solicitação de URL seja formatada da seguinte forma:
https://api.darksky.net/forecast/[SUA_CHAVE_SECRETA]/[LAT],[LONG]
O texto entre colchetes será preenchido com uma chave de API e o local do qual você quer a previsão do tempo.
No app Atalhos, coloque a chave de API do Dark Sky na primeira ação Texto, a qual é passada para a ação URL como uma variável. Os valores
LATeLONGjá estão definidos como37.8267e-122.4233, os quais são as coordenadas da Ilha de Alcatraz em São Francisco (você pode alterá-los para outra localização).Tente usar a ação “Obter Localização Atual” e colocá-la como uma Variável Mágica definida como Latitude e Longitude na ação URL para obter a previsão do tempo local sempre que o atalho for executado.
Faça a solicitação de API com a ação Obter Conteúdo de URL
No editor de atalhos do app Atalhos, defina “Obter Conteúdo do URL” como Avançado.
As seguintes opções dos tipos de solicitação de API que podem ser feitas são disponibilizadas:
GETpermite recuperar dados.POSTpermite criar novos dados.PUTpermite substituir dados para atualizá-los.PATCHpermite modificar dados para atualizá-los.DELETEpermite remover um objeto especificado na solicitação URL.
Para este exemplo, use uma solicitação
GETpara obter dados da API do Dark Sky.Agora que a ação URL tem a solicitação e a ação “Obter Conteúdo do URL” está configurada para
GET(obter) dados, a solicitação de API pode ser feita.Nota: quando a ação “Obter Conteúdo do URL” é alternada para
POST(publicar),PUT(colocar) ouPATCH(modificar), um novo parâmetro, chamado Pedir Corpo, é adicionado. Pedir Corpo permite que você envie um JSON, um Formulário ou um Arquivo à API, como parte da sua solicitação. Isso permite que você digite novos dados manualmente ou use variáveis para enviar os dados à API para criar, substituir ou modificar uma entrada.Toque em
para testar o atalho (a ação Visualização Rápida no atalho permite pré-visualizar os dados que a API retorna).
À primeira vista, a API parece retornar um texto bagunçado. Os dados climáticos são codificados em formato JSON, que significa JavaScript Object Notation (em inglês).
Para saber mais sobre como trabalhar com JSON e prosseguir com o exemplo da API do Dark Sky, consulte Introdução ao uso de JSON no Atalhos.