![](https://help.apple.com/assets/5C8ADDC1680CE21E4EE5E0AC/5C8ADDC9680CE21E4EE5E0B5/pt_PT/c10e8a839dc838a25d0feb0e9e428a0a.png)
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.
![Um pedido à API do Dark Sky que contém uma ação Texto com uma chave secreta de API, seguido por uma ação API que aponta para o ponto terminal da API através de uma variável "Chave secreta", seguido de uma ação "Obter conteúdo do URL.](https://help.apple.com/assets/5C8ADDC1680CE21E4EE5E0AC/5C8ADDC9680CE21E4EE5E0B5/pt_PT/22dae7009daf6596aa92f6fc5b287037.png)
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
eLAT
LONG
já estão definidos como37.8267
e-122.4233, que
sã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:
OBTER
permite-lhe obter dados.PUBLICAR
permite-lhe criar novos dados;COLOCAR
permite-lhe atualizar dados substituindo-os.CORRIGIR
permite-lhe atualizar dados modificando-os.APAGAR
permite-lhe remover um objeto especificado no pedido de URL.
Para este exemplo, use um pedido
OBTER
para 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
OBTER
dados, está pronto para efetuar o pedido à API.Nota: Quando a ação “Obter conteúdo do URL” muda para
PUBLICAR
,COLOCAR
ouCORRIGIR
, é 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.