Efetuar o primeiro pedido à API na aplicação Atalhos
para efetuar o primeiro pedido à API, tem de criar um URL que aponta para o “ponto terminal” da API com a qual pretende comunicar e, em seguida, passar esse URL para a ação “Obter conteúdo do URL”. Quando o atalho é executado, esta ação efetua o pedido à API.
Criar o pedido à API
O ponto final de previsão do Dark Sky exige que um pedido de URL esteja formatado da seguinte forma:
https://api.darksky.net/forecast/[A_CHAVE_SECRETA]/[LAT],[LONG]
O texto entre parênteses será preenchido com uma chave de API e o local para onde quer os dados de previsão.
Na aplicação Atalhos, coloque a chave de API do Dark Sky na primeira ação Texto, que é passada à ação URL como variável. Os valores
LATLONGjá estão definidos como37.8267e-122.4233, quesão as coordenadas da Ilha de Alcatraz em São Francisco (pode alterar esses valores para outro local).Experimente 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 de URL para obter os dados meteorológicos locais sempre que executar o atalho.
Efetuar o pedido à API com a ação “Obter conteúdo do URL”
No editor de atalhos da aplicação Atalhos, defina “Obter conteúdo do URL” como Avançado.
As seguintes opções para os tipos de pedido à API que pode efetuar ficam disponíveis:
OBTERpermite-lhe obter dados.PUBLICARpermite-lhe criar novos dados;COLOCARpermite-lhe atualizar dados substituindo-os.CORRIGIRpermite-lhe atualizar dados modificando-os.APAGARpermite-lhe remover um objeto especificado no pedido de URL.
Para este exemplo, use um pedido
OBTERpara obter dados da API do Dark Sky.Agora que a ação URL tem o seu pedido e a ação “Obter conteúdo do URL” está configurado para
OBTERdados, está pronto para efetuar o pedido à API.Nota: Quando a ação “Obter conteúdo do URL” muda para
PUBLICAR,COLOCARouCORRIGIR, é adicionado um novo parâmetro denominado “Pedir corpo”. O parâmetro “Pedir corpo” permite-lhe enviar JSON, um formulário ou um ficheiro à API como parte do seu pedido. Desta forma, pode introduzir novos dados de forma manual ou através de variáveis, para que possa enviar dados à API para criar, substituir ou modificar uma entrada.Toque em
para testar o atalho (a ação “Vista rápida” no atalho permite-lhe pré-visualizar os dados devolvidos pela API).
À primeira vista, a API parece devolver uma grande quantidade de texto. Estes dados meteorológicos estão codificados em JSON, que é a abreviatura de JavaScript Object Notation.
Encontrará informação adicional sobre como trabalhar com JSON e continuar o exemplo API do Dark Sky em Introdução à utilização de JSON na aplicação Atalhos.