Che cos'è l'API REST e come puoi acquisire dati per la tua app o il tuo sito web?

La sigla API sta per interfaccia di programmazione dell'applicazione. Un API è un insieme di funzioni che facilita la comunicazione tra due applicazioni software. In sostanza, an API prende una richiesta da un'applicazione software a un'altra, quindi ritorna al software di avvio con una risposta pertinente.

RIPOSO significa trasferimento di stato rappresentativo ed è un'architettura utilizzata per progettare applicazioni client-server. Con un API di riposo, stai ricevendo una rappresentazione dei dati richiesti archiviati in un database. UN API REST è anche senza stato, il che significa che il server non memorizza alcun dato tra le richieste dei client.

Se stai cercando un API di riposo esempio e una spiegazione approfondita di come funziona, continua a leggere.

Come funziona un'API REST?

UN API REST accede ai dati tramite identificatori di risorse uniformi (URI), che è una stringa di caratteri che identifica una risorsa specifica. Il tipo di URI usato da a API REST è un URL (Uniform Resource Locator).

Per accedere e manipolare le risorse, un REST API utilizza i seguenti verbi di richiesta:

• Get (viene utilizzato per acquisire dati da un database)
• Posta (aggiungi nuovi dati a un database)
• Metti (aggiorna i dati in un database)
• Elimina (elimina dati da un database)

Se vuoi usufruire dei servizi di uno dei tanti API REST disponibile sul web (invece di crearne uno da zero), avrai accesso solo al verbo di richiesta get del API REST (tramite un URL). Questi URL hanno diversi componenti, ma quelli che devi sapere sono i API chiave e la query.

Il API key è un identificatore univoco, che riceverai una volta registrato su a API REST piattaforma. La query è solitamente una semplice equazione utilizzata per personalizzare la ricerca. Pertanto, se desideri ottenere il tempo attuale a New York City, la sezione di query del tuo URL potrebbe essere "city=New York".

L'esecuzione di una richiesta get restituisce una risposta, che contiene un codice di stato e un corpo. Se la richiesta ha esito positivo, il corpo della tua risposta conterrà i dati che desideri utilizzare sul tuo sito web o applicazione.

Utilizzo di un'applicazione JavaScript per acquisire dati da diverse API Rest

Per creare questa semplice applicazione, ci sono altre due applicazioni software che devi installare sul tuo computer: NodeJS e npm. Abbiamo scritto un articolo su come installare NodeJS e npm su Ubuntu, così come uno su come farlo su Windows- quindi dai un'occhiata a quelli se vuoi saperne di più.

Dopo aver installato le applicazioni di cui sopra sul tuo computer, dovrai eseguire i seguenti passaggi:

1. Apri il tuo IDE e avvia il terminale.
2. Passare alla cartella contenente il file dell'applicazione JavaScript utilizzando il comando cd.
3. Inizializza npm con la seguente riga di codice:

npm init -y

C'è un modulo npm che svolgerà un ruolo chiave nella funzionalità di questa applicazione. Questo è il modulo ottenuto, che è una libreria di richieste HTTP per NodeJS. La seguente riga di codice installerà l'ultima versione della libreria ottenuta nei file dell'applicazione:

npm install got@latest

Ora puoi andare avanti e creare la tua applicazione.

Utilizzo della libreria ottenuta per creare la tua applicazione

//importa la libreria ottenuta nella tua applicazione
const got = require('got');
// recupera i dati da una specifica API REST e ne stampa il corpo sul terminale
(asincrono() => {
Tentativo {
const risposta = attendere ottenuto (URL);
const data = JSON.parse (response.body);
console.log (dati);
} cattura (errore) {
console.log (error.data);
}
})();

L'applicazione sopra acquisterà dati da qualsiasi API REST In rete. Tuttavia, dovrai prima fornire l'URL per la risorsa pertinente.

Acquisizione di dati da un'API REST meteo

Il Weatherbit.io API è uno dei meteo più popolari API REST. Inserimento dell'URL di questo API nella semplice applicazione JavaScript sopra renderà l'app operativa.

Utilizzo dell'API REST Weatherbit.io

//importa la libreria ottenuta nella tua applicazione
const got = require('got');
// recupera i dati da una specifica API REST e ne stampa il corpo sul terminale
(asincrono() => {
Tentativo {
const URL = ' https://api.weatherbit.io/v2.0/current? lat=40,7128&lon=-74.0060&key=API_KEY';
const risposta = attendere ottenuto (URL);
const data = JSON.parse (response.body);
console.log (dati);
} cattura (errore) {
console.log (error.data);
}
})();

L'URL per Weatherbit.io API è ora inserito con successo nell'applicazione. Tuttavia, c'è un aspetto dell'URL che devi regolare per far funzionare l'applicazione. Questa è la sezione denominata "API_KEY" e questa chiave è ciò che riceverai da Weatherbit.io quando ti registri per un account gratuito.

Hai anche la possibilità di modificare la sezione della query nel codice sopra. L'applicazione sta attualmente interrogando il meteo alla latitudine di 40,7128 e alla longitudine di -74.0060, ma è possibile inserire nuove coordinate. Sebbene la query sopra sia l'approccio consigliato, puoi cercare il tempo in una località utilizzando il nome della città.

Per ulteriori informazioni su come utilizzare Weatherbit.io API REST, clicca qui.

Dopo aver inserito il tuo API key nella sezione pertinente sopra, ora puoi eseguire il tuo file JavaScript. L'applicazione fornirà qualcosa di simile al seguente output nel tuo terminale.

Esempio di risposta API REST di Weatherbit.io

dati: [
{
dx: 53,
pod: 'd',
lungo: -74.01,
pre: 1005.9,
fuso orario: 'America/New_York',
ob_time: '2021-09-27 14:50',
country_code: "USA",
nuvole: 25,
ts: 1632754200,
rad_solare: 652.8,
codice_stato: "NY",
city_name: 'New York City',
wind_spd: 5.66,
wind_cdir_full: 'ovest-sudovest',
wind_cdir: 'WSW',
slp: 1015,9,
vis: 5,
h_angolo: -30,
tramonto: '22:44',
dni: 851.72,
rugiada: 12,
neve: 0,
uv: 5.68859,
precipito: 0,
vento_dir: 240,
alba: '10:49',
ghi: 657.55,
dhi: 106.79,
aqi: 53,
lat: 40.71,
tempo: [Oggetto],
data e ora: '2021-09-27:14',
temperatura: 22,
stazione: 'KJRB',
elev_angle: 40.89,
app_temp: 21,7
}
],
conteggio: 1
}

Alcuni degli aspetti più importanti dei dati restituiti nella risposta includono:

• Nome della città (restituisce il nome della città alla longitudine e latitudine fornite).
• Appuntamento (restituisce l'ora del ciclo corrente nel formato AAAA-MM-GG: HH).
• Tempo metereologico (restituisce un oggetto contenente un'icona meteo, un codice meteo e una descrizione testuale del meteo).

Acquisizione di dati da un'API REST di notizie

Le notizie API utilizzato in questa sezione è Newsdata.io. Come tutti API REST sul Web, fornisce diverse opzioni di query, che è possibile utilizzare per recuperare le ultime notizie da tutto il mondo. Con Newsdata.io API, puoi ricevere notizie da un paese specifico o in una particolare lingua, categoria e così via.

Utilizzando l'applicazione JavaScript, puoi recuperare i dati dalle notizie API REST. Sostituisci semplicemente l'URL nell'applicazione sopra con il seguente URL:

' https://newsdata.io/api/1/news? apikey=YOUR_API_KEY&country=us'

Il passaggio successivo consiste nel sostituire la sezione "YOUR_API_KEY" nell'URL sopra con API chiave che riceverai dopo esserti registrato su Newsdata.io. L'URL sopra riportato restituirà le ultime notizie dall'America. Tuttavia, se desideri notizie dal Giappone, puoi semplicemente sostituire la query "contry=us" con "country=jp".

Per ulteriori informazioni su come utilizzare Newsdata.io API REST, clicca qui.

Imparentato: Vuoi aggiungere titoli di notizie al tuo sito Web o alla tua app? Hai bisogno dell'API Mediastack

Esempio di risposta dell'API REST di Newsdata.io

{
titolo: "Autista ucciso dalla sua stessa portiera della macchina mentre aspettava in fila al fast food drive-thru, fornendo informazioni cautelative per le auto a guida autonoma con intelligenza artificiale",
collegamento: ' https://www.forbes.com/sites/lanceeliot/2021/09/27/driver-killed-by-his-own-car-door-while-waiting-in-line-at-fast-food-drive-thru-providing-cautionary-insights-for-ai-self-driving-cars/',
parole chiave: [Array],
creatore: [array],
URL_video: nullo,
descrizione: "Una triste notizia su un guidatore che è stato ucciso dalla portiera della sua stessa macchina (mentre si trovava in un drive-thru), fornisce approfondimenti cautelativi su
l'avvento delle auto a guida autonoma basate sull'intelligenza artificiale. Ecco il look dell'insider.",
contenuto: "Una triste notizia su un guidatore che è stato ucciso dalla portiera della sua stessa auto (mentre si trovava in un drive-thru), fornisce approfondimenti cautelativi sul
avvento delle auto a guida autonoma basate sull'intelligenza artificiale. Ecco il look dell'insider.",
data pub: '2021-09-27 15:30:00',
URL dell'immagine: ' https://thumbor.forbes.com/thumbor/fit-in/0x0/filters%3Aformat%28jpg%29/https://specials-images.forbesimg.com/imageserve/614272b9f18bec6882652695/0x0.jpg? cropX1=23&cropX2=2455&cropY1=23&cropY2=1538',
source_id: 'forbes'
}

Utilizzo di un'applicazione Python per acquisire dati da diverse API di riposo

È possibile acquisire dati per il tuo sito Web o applicazione utilizzando qualsiasi linguaggio di programmazione con cui hai familiarità. Quindi, se non vuoi usare JavaScript, puoi ottenere gli stessi risultati con un'applicazione Python.

Imparentato: Come creare API in Python: framework popolari

Tutto quello che devi fare è installare il modulo python HTTP delle richieste usando l'ambiente pip. Quindi, puoi creare la tua applicazione Python usando il seguente codice:

# importa la libreria delle richieste
richieste di importazione
# acquisizione di dati utilizzando la libreria delle richieste
URL = ' https://newsdata.io/api/1/sources? apikey=YOUR_API_KEY=noi'
res = request.get (URL)
json = res.json()
per la chiave in json:
print (chiave, json[chiave])

Come negli esempi precedenti, dovrai inserire il tuo API chiave nella relativa sezione. Riceverai quindi gli stessi dati restituiti dall'applicazione JavaScript.

Acquisire dati per il tuo sito Web o applicazione è piuttosto semplice

Ora hai gli strumenti necessari per acquisire i dati per le tue applicazioni software. È importante ricordare che il RIPOSO l'architettura facilita l'accoppiamento lasco, il che significa che è possibile utilizzare qualsiasi linguaggio di programmazione per acquisire dati da qualsiasi API REST In rete.

Ora sai come usare API di riposo, perché non provarci?

Scraping Web vs. API: qual è il modo migliore per estrarre i dati?

Ci sono dati ovunque, ma metterci le mani sopra è un altro problema, ammesso che sia legale.

Leggi Avanti

Circa l'autore