Ce este API-ul REST și cum puteți obține date pentru aplicația sau site-ul dvs. web?

Acronimul API reprezintă interfața de programare a aplicației. Un API este un set de funcții care facilitează comunicarea între două aplicații software. În esență, un API preia o cerere de la o aplicație software la alta, apoi revine la software-ul inițiator cu un răspuns relevant.

ODIHNĂ înseamnă transfer de stare reprezentativă și este o arhitectură utilizată pentru proiectarea aplicațiilor client-server. Cu API Rest, veți obține o reprezentare a datelor solicitate stocate într-o bază de date. A API REST este, de asemenea, apatrid, ceea ce înseamnă că serverul nu stochează date între solicitările clienților.

Dacă sunteți în căutarea unui API Rest exemplu și o explicație aprofundată a modului în care funcționează, continuați să citiți.

Cum funcționează un API REST?

A API REST accesează date prin identificatori de resurse uniformi (URI), care este un șir de caractere care identifică o resursă specifică. Tipul de URI utilizat de un API REST este un localizator de resurse uniform (URL).

Pentru a accesa și manipula resurse, o REST API folosește următoarele verbe de solicitare:

• Obțineți (aceasta este utilizată pentru a obține date dintr-o bază de date)
• Postați (adăugați date noi la o bază de date)
• Puneți (actualizați datele într-o bază de date)
• Ștergeți (ștergeți datele dintr-o bază de date)

Dacă doriți să utilizați serviciile unuia dintre multele APOI REST disponibil pe web (în loc să creați unul de la zero), veți avea acces doar la verbul get request al API REST (printr-o adresă URL). Aceste adrese URL au mai multe componente, dar cele pe care trebuie să le cunoașteți sunt API cheie și interogarea.

The API cheie este un identificator unic, pe care îl veți primi odată ce vă înregistrați pe un API REST platformă. Interogarea este de obicei o ecuație simplă utilizată pentru a vă personaliza căutarea. Prin urmare, dacă doriți să obțineți vremea actuală în New York, secțiunea de interogare a adresei URL ar putea fi „oraș = New York”.

Executarea unei cereri de obținere returnează un răspuns, care conține un cod de stare și un corp. Dacă solicitarea are succes, organismul dvs. de răspuns va conține datele pe care doriți să le utilizați pe site-ul sau aplicația dvs.

Utilizarea unei aplicații JavaScript pentru a prelua date din diferite API-uri de repaus

Pentru a construi această aplicație simplă, există alte două aplicații software pe care trebuie să le instalați pe computer: NodeJS și npm. Am scris un articol despre cum să instalați NodeJS și npm pe Ubuntu, precum și unul pe cum se face acest lucru pe Windows- deci verificați-le dacă doriți să aflați mai multe.

După ce aplicațiile de mai sus sunt instalate pe computer, va trebui să parcurgeți următorii pași:

1. Deschideți IDE-ul și lansați terminalul.
2. Navigați la folderul care conține fișierul aplicației JavaScript utilizând comanda cd.
3. Inițializați npm cu următoarea linie de cod:

npm init -y

Există un modul npm care va juca un rol cheie în funcționalitatea acestei aplicații. Acesta este modulul got, care este o bibliotecă de solicitări HTTP pentru NodeJS. Următoarea linie de cod va instala cea mai recentă versiune a bibliotecii got în fișierele aplicației dvs.:

npm install got @ latest

Acum puteți merge mai departe și vă puteți construi aplicația.

Utilizarea Bibliotecii Got pentru a vă crea aplicația

// importați biblioteca obținută în aplicația dvs.
const got = require ('got');
// preluați date dintr-un anumit API REST și imprima corpul acestuia la terminal
(async () => {
încerca {
raspuns const = await got (URL);
const data = JSON.parse (response.body);
console.log (date);
} captură (eroare) {
console.log (error.data);
}
})();

Aplicația de mai sus va prelua date de la orice API REST pe internet. Cu toate acestea, va trebui să furnizați mai întâi adresa URL pentru resursa relevantă.

Preluarea datelor dintr-o API REST Weather

Weatherbit.io API este una dintre cele mai populare vreme APOI REST. Se introduce adresa URL a acesteia API în aplicația simplă JavaScript de mai sus va face aplicația operațională.

Folosind API-ul REST Weatherbit.io

// importați biblioteca obținută în aplicația dvs.
const got = require ('got');
// preluați date dintr-un anumit API REST și imprima corpul acestuia la terminal
(async () => {
încerca {
const URL = ' https://api.weatherbit.io/v2.0/current? lat = 40.7128 & lon = -74.0060 & key = API_KEY ';
raspuns const = await got (URL);
const data = JSON.parse (response.body);
console.log (date);
} captură (eroare) {
console.log (error.data);
}
})();

Adresa URL pentru Weatherbit.io API este acum introdus cu succes în aplicație. Cu toate acestea, există un aspect al adresei URL pe care trebuie să îl ajustați pentru ca aplicația să ruleze. Aceasta este secțiunea denumită „API_KEY”, iar această cheie este ceea ce veți primi de la Weatherbit.io când vă înregistrați pentru un cont gratuit.

De asemenea, aveți opțiunea de a regla secțiunea de interogare din codul de mai sus. Aplicația solicită momentan vremea la latitudinea de 40,7128 și longitudinea de -74,0060, dar puteți insera noi coordonate. Deși interogarea de mai sus este abordarea recomandată, puteți căuta vremea într-o locație folosind numele orașului.

Pentru mai multe informații despre cum să utilizați Weatherbit.io API REST, Click aici.

După introducerea API tasta din secțiunea relevantă de mai sus, acum puteți executa fișierul JavaScript. Aplicația va furniza ceva similar cu următoarea ieșire din terminalul dvs.

Weatherbit.io REST API Exemplu de răspuns

date: [
{
rh: 53,
pod: 'd',
lon: -74.01,
pres: 1005,9,
fus orar: „America / New_York”,
ob_time: '2021-09-27 14:50',
country_code: „SUA”,
nori: 25,
ts: 1632754200,
solar_rad: 652.8,
state_code: 'NY',
city_name: „New York City”,
wind_spd: 5.66,
wind_cdir_full: 'vest-sud-vest',
wind_cdir: „WSW”,
slp: 1015,9,
viz: 5,
h_angle: -30,
apusul soarelui: '22: 44 ',
dni: 851,72,
scurgere: 12,
zăpadă: 0,
uv: 5.68859,
precip: 0,
wind_dir: 240,
răsărit: '10: 49 ',
ghi: 657,55,
dhi: 106,79,
aqi: 53,
lat: 40,71,
vreme: [Obiect],
datetime: „2021-09-27: 14”,
temp: 22,
stație: „KJRB”,
elev_angle: 40.89,
app_temp: 21.7
}
],
număr: 1
}

Unele dintre aspectele mai importante ale datelor returnate în răspuns includ:

• Numele orasului (returnează numele orașului la longitudinea și latitudinea furnizate).
• Datetime (returnează ora curentă a ciclului în format AAAA-LL-ZZ: HH).
• Vreme (returnează un obiect care conține o pictogramă meteo, cod meteo și o descriere text a vremii).

Preluarea datelor dintr-o API REST News

Stirile API utilizat în această secțiune este Newsdata.io. Ca toți APOI REST pe web, oferă mai multe opțiuni de interogare, pe care le puteți utiliza pentru a prelua știri de ultimă oră din întreaga lume. Cu Newsdata.io API, puteți obține știri dintr-o anumită țară sau într-o anumită limbă, categorie etc.

Folosind aplicația JavaScript, puteți prelua date din știri API REST. Pur și simplu înlocuiți adresa URL din aplicația de mai sus cu următoarea adresă URL:

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

Următorul pas este să înlocuiți secțiunea „YOUR_API_KEY” din adresa URL de mai sus cu API cheie pe care o veți primi după ce vă înregistrați la Newsdata.io. Adresa URL de mai sus va întoarce știri de ultimă oră din America. Cu toate acestea, dacă doriți știri din Japonia, puteți înlocui pur și simplu interogarea „contry = us” cu „country = jp”.

Pentru mai multe informații despre cum să utilizați Newsdata.io API REST, Click aici.

Legate de: Doriți să adăugați titluri de știri pe site-ul sau aplicația dvs.? Aveți nevoie de API Mediastack

Newsdata.io Exemplu de răspuns REST API

{
title: „Șoferul ucis de propria ușă a mașinii în timp ce aștepta la coadă la Fast-Food Drive-Thru, oferind informații precauționale pentru autovehiculele cu auto-conducere AI”,
link: ' 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/',
cuvinte cheie: [Matrice],
creator: [Array],
video_URL: nul,
descriere: „Povestea tristă despre un șofer care a fost ucis de propria ușă a mașinii (în timp ce se afla în mașină), oferă informații precauționale despre
apariția mașinilor cu auto-conducere bazate pe AI. Iată aspectul din interior. ",
conținut: „Povestea tristă despre un șofer care a fost ucis de propria ușă a mașinii (în timp ce se afla într-un autovehicul), oferă informații precauționale despre
apariția mașinilor cu conducere automată bazate pe AI. Iată aspectul din interior. ",
pubDate: '2021-09-27 15:30:00',
Imagine URL: ' 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'
}

Utilizarea unei aplicații Python pentru a prelua date din diferite API-uri de repaus

Este posibil să obțineți date pentru site-ul sau aplicația dvs. utilizând orice limbaj de programare pe care îl cunoașteți. Deci, dacă nu doriți să utilizați JavaScript, puteți obține aceleași rezultate cu o aplicație Python.

Legate de: Cum să construiți API-uri în Python: cadre populare

Tot ce trebuie să faceți este să instalați modulul de cereri HTTP python utilizând mediul pip. Apoi, puteți construi aplicația Python folosind următorul cod:

# importați biblioteca de cereri
solicitări de import
# preluarea datelor folosind biblioteca de cereri
URL = ' https://newsdata.io/api/1/sources? apikey = YOUR_API_KEY = noi '
res = requests.get (URL)
json = res.json ()
pentru cheie în json:
print (cheie, json [cheie])

Similar cu exemplele anterioare, va trebui să introduceți API cheie în secțiunea relevantă. Veți primi apoi aceleași date pe care le returnează aplicația JavaScript.

Preluarea datelor pentru site-ul sau aplicația dvs. este destul de simplă

Acum aveți instrumentele de care aveți nevoie pentru a obține date pentru aplicațiile software. Este important să ne amintim că ODIHNĂ arhitectura facilitează cuplarea liberă, ceea ce înseamnă că puteți utiliza orice limbaj de programare pentru a prelua date de la oricare API REST pe internet.

Acum știi cum să folosești API Rest, de ce să nu încerci?

Web Scraping vs. API: Care este cel mai bun mod de a extrage date?

Există date peste tot, dar punerea mâinii pe ele este o altă problemă - chiar dacă este legală.

Citiți în continuare

Despre autor