![](https://help.apple.com/assets/5D66C362680CE25E7861EFB5/5D66C38B680CE25E7861EFC5/it_IT/c10e8a839dc838a25d0feb0e9e428a0a.png)
Effettua la tua prima richiesta API in Comandi Rapidi
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 Dark Sky che contiene un'azione Testo con una chiave API segreta, seguita da un'azione URL che indica l'endpoint dell'API tramite una variabile “Chiave segreta”, seguita da un'azione “Ottieni contenuti dell'URL”.](https://help.apple.com/assets/5D66C362680CE25E7861EFB5/5D66C38B680CE25E7861EFC5/it_IT/4eb15c3d0294a4f996ba2f8f338aa154.png)
Creare la richiesta API
L'endpoint delle previsioni di Dark Sky necessita di una richiesta URL da formattare come:
https://api.darksky.net/forecast/[LA_TUA_CHIAVE_SEGRETA]/[LAT],[LONG]
Il testo tra parentesi verrà compilato con una chiave API e la posizione per cui vuoi ricevere i dati sulle previsioni.
Nell'app Comandi Rapidi, posiziona la chiave API Dark Sky nella prima azione Testo, che viene passata all'azione URL come variabile.
LAT
eLONG
sono già impostate su37.8267
e-122.4233
, le coordinate dell'isola di Alcatraz a San Francisco. (Puoi modificare tali valori in una posizione differente).Prova a utilizzare l'azione “Ottieni posizione attuale” e a posizionarla come variabile magica per impostare latitudine e longitudine nell'azione URL, al fine di recuperare i dati locali ovunque tu voglia eseguire il comando rapido.
Esegui la richiesta API con l'azione “Ottieni contenuti dell'URL”
Nell'editor di comandi rapidi nell'app Comandi Rapidi, imposta “Ottieni contenuti dell'URL” su Avanzato.
Le seguenti opzioni per i tipi di richieste API che puoi effettuare diventano disponibili:
OTTIENI
consente di recuperare dati.PUBBLICA
consente di creare nuovi dati.INSERISCI
consente di aggiornare i dati sostituendoli.PATCH
consente di aggiornare i dati modificandoli.ELIMINA
consente di rimuovere un oggetto specificato nella richiesta dell'URL.
Per questo esempio, usa una richiesta
OTTIENI
per recuperare i dati dall'API Dark Sky.Ora che l'azione URL dispone della tua richiesta e l'opzione “Ottieni contenuti dell'URL” è impostata su
OTTIENI
dati, sei pronto per effettuare la richiesta API.Nota: quando “Ottieni contenuti dell'URL” è impostato su
PUBBLICA
,INSERISCI
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.Tocca
per verificare il comando rapido (l'azione “Visualizzazione rapida” nel comando rapido consente di visualizzare l'anteprima dei dati che l'API restituisce).
A un primo sguardo, l'API sembra restituire un insieme caotico di testi. Questi dati meteorologici sono codificati in JSON, ossia JavaScript Object Notation.
Per ulteriori informazioni su come lavorare con JSON e per continuare con l'esempio dell'API Dark Sky, consulta Introduzione all'uso di JSON in Comandi Rapidi.