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.
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.
LATeLONGsono già impostate su37.8267e-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:
OTTIENIconsente di recuperare dati di lettura da un’API.PUBBLICAconsente di creare nuovi dati.INSERISCIePATCHconsentono di aggiornare i dati sostituendoli o modificandoli rispettivamente.ELIMINAconsente di rimuovere un oggetto specificato nella richiesta dell’URL.
Per questo esempio, usa una richiesta
OTTIENIper 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
OTTIENIdati, sei pronto per effettuare la richiesta API.Nota: quando “Ottieni contenuti dell’URL” è impostato su
PUBBLICA,INSERISCIoPATCH, 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).
Congratulazioni, hai effettuato la tua prima richiesta API completa utilizzando Comandi Rapidi.
A un primo sguardo, l’API sembra restituire molti testi formattati in modo inconsueto. Guardando meglio, puoi vedere che il testo contiene informazioni sulle previsioni del tempo. 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 Informazioni sull’uso di JSON in Comandi Rapidi.