![](https://help.apple.com/assets/645D5D228BE0233D28263F4B/645D5D258BE0233D28263F5A/pt_PT/389e356d55e928d40def9c16d476e5e0.png)
Pedir a primeira API na aplicação Atalhos no iPhone ou iPad
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 que contém uma ação URL que aponta para o ponto terminal da API, seguido de uma ação “Obter conteúdo do URL”.](https://help.apple.com/assets/645D5D228BE0233D28263F4B/645D5D258BE0233D28263F5A/pt_PT/b67914aeeb82692629920c182f8d1154.png)
Criar o pedido à API
O ponto final de Typicode exige que um pedido de URL esteja formatado da seguinte forma:
https://jsonplaceholder.typicode.com/[RESOURCE]
O texto entre parênteses retos é o recurso a que gostaria de aceder. Typicode disponibiliza vários exemplos para testar pedidos. Este exemplo usará https://jsonplaceholder.typicode.com/users
para pedir uma lista de utilizadores.
Na aplicação Atalhos
no dispositivo iOS ou iPadOS, adicione o pedido ao URL.
O pedido
users
devolverá uma lista de utilizadores.Pode limitar a pesquisa especificando um utilizador em específico pelo id:
https://jsonplaceholder.typicode.com/users/6
. Isso devolverá o utilizador cuja id é 6.A maioria das API permitem consultas com o seguinte formato:
https://jsonplaceholder.typicode.com/users?username=Bret
. O “?” inicia a consulta, que procura elementos com pares de chaves/valores. Neste exemplo, a consulta?username=Bret
procura por um utilizador cujo nome de utilizador é Bret.Consulte a documentação da API para pesquisas e consultas compatíveis.
Efetuar o pedido à API com a ação “Obter conteúdo do URL”
Na aplicação Atalhos
no dispositivo iOS ou iPadOS, toque em “Mostrar mais” na ação “Obter conteúdo do URL”.
As seguintes opções para os tipos de pedido à API que pode efetuar ficam disponíveis:
GET
permite-lhe obter dados.POST
permite-lhe criar novos dados;PUT
permite-lhe atualizar dados substituindo-os.PATCH
permite-lhe atualizar dados modificando-os.DELETE
permite-lhe remover um objeto especificado no pedido de URL.
Para este exemplo, use um pedido
GET
para obter dados da API Typicode.Agora que a ação URL tem o seu pedido e a ação “Obter conteúdo do URL” está configurado para
GET
dados, está pronto para efetuar o pedido à API.Nota: Quando a ação “Obter conteúdo do URL” muda para
POST
,PUT
ouPATCH
, é 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.Para testar o atalho, toque em
.
À primeira vista, a API parece devolver uma grande quantidade de texto. Estes dados 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 Typicode em Introdução à utilização de JSON na aplicação Atalhos no iPhone e iPad.