![](https://help.apple.com/assets/5B296C8B680CE27831E138C3/5B296C8E680CE27831E138D3/pt_BR/c10e8a839dc838a25d0feb0e9e428a0a.png)
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.
![Uma solicitação de API do Dark Sky que contém uma ação de Texto com uma chave secreta de API, seguida de uma ação URL que usa uma variável Chave Secreta para apontar para o endpoint da API, seguida de uma ação Obter Conteúdo do URL.](https://help.apple.com/assets/5B296C8B680CE27831E138C3/5B296C8E680CE27831E138D3/pt_BR/d4a742722dbbd42f9d384427c726e1c7.png)
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
LAT
eLONG
já estão definidos como37.8267
e-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:
GET
permite que você obtenha dados de uma API para leitura.POST
permite criar novos dados.PUT
ePATCH
permitem que você atualize dados substituindo-os ou modificando-os, respectivamente.DELETE
permite que você remova um objeto especificado na solicitação URL.
Para este exemplo, use uma solicitação
GET
para 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).
Parabéns, você fez sua primeira solicitação de API usando o Atalhos.
À primeira vista, a API parece retornar um texto em formatação estranha. Ao olhar detalhadamente, você poderá ver que o texto contém informações de previsão do tempo. 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 Sobre o uso de JSON no Atalhos.