Effettua la tua prima richiesta API in Comandi Rapidi sul Mac
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 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 Mac, aggiungi la richiesta all'URL.La richiesta
usersrestituirà 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=Bretcerca 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 Mac, fai clic su “Mostra altro” nell'azione “Ottieni contenuti dell'URL”.Le seguenti opzioni per i tipi di richieste API che puoi effettuare diventano disponibili:
GETconsente di recuperare dati.POSTconsente di creare nuovi dati.PUTconsente di aggiornare i dati sostituendoli.PATCHconsente di aggiornare i dati modificandoli.DELETEconsente di rimuovere un oggetto specificato nella richiesta dell'URL.
Per questo esempio, usa una richiesta
GETper recuperare i dati dall'API Typicode.Ora che l'azione URL dispone della tua richiesta e l'opzione “Ottieni contenuti dell'URL” è impostata su
GETdati, sei pronto per effettuare la richiesta API.Nota: quando “Ottieni contenuti dell'URL” è impostato su
POST,PUToPATCH, 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, seleziona
.
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'uso di JSON in Comandi Rapidi sul Mac.