![](https://help.apple.com/assets/63A24242BFFB1C67B5512B26/63A24245BFFB1C67B5512B35/it_IT/389e356d55e928d40def9c16d476e5e0.png)
Richiedere la prima API in Comandi Rapidi su iPhone o iPad
Per effettuare una richiesta con la tua prima API, crea l'URL orientato verso l'endpoint dell'API a cui ti vuoi rivolgere, quindi passa l'URL all'azione “Ottieni contenuti dell'URL”. Quando il comando rapido è in esecuzione, l'azione effettua la richiesta API.
![Una richiesta di un'API che contiene un'azione URL che indica l'endpoint dell'API, seguita da un'azione “Ottieni contenuti dell'URL”.](https://help.apple.com/assets/63A24242BFFB1C67B5512B26/63A24245BFFB1C67B5512B35/it_IT/a66d93593edd640f3f262a591c579ea8.png)
Creare la richiesta API
L'endpoint di Typicode ha bisogno di una richiesta URL da formattare in questo modo:
https://jsonplaceholder.typicode.com/[RESOURCE]
Il testo tra parentesi è la risorsa a cui desideri accedere. Typicode fornisce molti esempi differenti di richieste di test. Questo esempio utilizzerà https://jsonplaceholder.typicode.com/users
per richiedere un elenco di utenti.
Nell'app Comandi Rapidi
sul tuo dispositivo iOS o iPadOS, aggiungi la richiesta all'URL.
La richiesta
users
restituirà un elenco di utenti.Puoi restringere la ricerca specificando un utente specifico tramite l'ID:
https://jsonplaceholder.typicode.com/users/6
. Questo restituirà l'utente il cui ID è 6.Molte API consentono query con il seguente formato:
https://jsonplaceholder.typicode.com/users?username=Bret
. “?” avvia la query, che cerca gli elementi utilizzando coppie di chiavi/valori. In questo esempio, la query?username=Bret
cerca un utente il cui nome è Bret.Consulta la documentazione dell'API per verificare le ricerche e le query supportate.
Esegui la richiesta API con l'azione “Ottieni contenuti dell'URL”
Nell'app Comandi Rapidi
sul tuo dispositivo iOS o iPadOS, tocca “Mostra altro” nell'azione “Ottieni contenuti dell'URL”.
Le seguenti opzioni per i tipi di richieste API che puoi effettuare diventano disponibili:
GET
consente di recuperare dati.POST
consente di creare nuovi dati.PUT
consente di aggiornare i dati sostituendoli.PATCH
consente di aggiornare i dati modificandoli.DELETE
consente di rimuovere un oggetto specificato nella richiesta dell'URL.
Per questo esempio, usa una richiesta
GET
per recuperare i dati dall'API Typicode.Ora che l'azione URL dispone della tua richiesta e l'opzione “Ottieni contenuti dell'URL” è impostata su
GET
dati, sei pronto per effettuare la richiesta API.Nota: quando “Ottieni contenuti dell'URL” è impostato su
POST
,PUT
oPATCH
, viene aggiunto un nuovo parametro chiamato “Richiedi corpo”. “Richiedi corpo” consente di inviare un JSON, un modulo o un file all'API come parte della tua richiesta. Ciò consente di inserire manualmente nuovi dati o utilizzando le variabili, in modo che tu possa inviare i dati all'API per creare, sostituire o modificare un'entrata.Per testare il comando rapido, tocca
.
A un primo sguardo, l'API sembra restituire un insieme caotico di testi. Questi dati sono codificati in JSON, ossia JavaScript Object Notation.
Per ulteriori informazioni su come lavorare con JSON e per continuare con l'esempio dell'API Typicode, consulta Introduzione all'utilizzo di JSON in Comandi Rapidi su iPhone o iPad.