Co to jest REST API i jak możesz pobrać dane do swojej aplikacji lub witryny?

Akronim API oznacza interfejs programowania aplikacji. jakiś API to zestaw funkcji ułatwiających komunikację między dwoma aplikacjami. Zasadniczo API przyjmuje żądanie z jednej aplikacji do drugiej, a następnie powraca do oprogramowania inicjującego z odpowiednią odpowiedzią.

ODPOCZYNEK oznacza reprezentatywny transfer stanu i jest to architektura używana do projektowania aplikacji klient-serwer. Z Reszta API, otrzymujesz reprezentację żądanych danych przechowywanych w bazie danych. A REST API jest również bezstanowy, co oznacza, że ​​serwer nie przechowuje żadnych danych między żądaniami od klientów.

Jeśli szukasz Reszta API przykład i szczegółowe wyjaśnienie, jak to działa, czytaj dalej.

Jak działa REST API?

A REST API uzyskuje dostęp do danych za pośrednictwem jednolitych identyfikatorów zasobów (URI), czyli ciągu znaków identyfikujących określony zasób. Typ identyfikatora URI używanego przez a REST API to jednolity lokalizator zasobów (URL).

Aby uzyskać dostęp do zasobów i manipulować nimi, REST API używa następujących czasowników żądania:

• Pobierz (służy do pozyskiwania danych z bazy danych)
• Opublikuj (dodaj nowe dane do bazy danych)
• Put (aktualizacja danych w bazie danych)
• Usuń (usuń dane z bazy danych)

Jeśli chcesz skorzystać z usług jednego z wielu REST API dostępne w sieci (zamiast budować je od zera), będziesz mieć dostęp tylko do czasownika żądania get the REST API (poprzez adres URL). Te adresy URL składają się z kilku elementów, ale te, o których musisz wiedzieć, to API klucz i zapytanie.

ten API klucz to unikalny identyfikator, który otrzymasz po zarejestrowaniu się na REST API Platforma. Zapytanie jest zwykle prostym równaniem używanym do personalizacji wyszukiwania. Dlatego jeśli chcesz uzyskać aktualną pogodę w Nowym Jorku, sekcja zapytania w adresie URL może mieć postać „miasto=Nowy Jork”.

Wykonanie żądania get zwraca odpowiedź, która zawiera kod statusu i treść. Jeśli żądanie zakończy się powodzeniem, treść odpowiedzi będzie zawierać dane, których chcesz użyć na swojej stronie internetowej lub w aplikacji.

Używanie aplikacji JavaScript do pobierania danych z różnych interfejsów API Rest

Aby zbudować tę prostą aplikację, musisz zainstalować na swoim komputerze dwie inne aplikacje: NodeJS i npm. Napisaliśmy artykuł o tym, jak zainstalować NodeJS i npm na Ubuntu, a także jeden na jak to zrobić w systemie Windows— więc sprawdź je, jeśli chcesz dowiedzieć się więcej.

Po zainstalowaniu powyższych aplikacji na komputerze musisz wykonać następujące czynności:

1. Otwórz swoje IDE i uruchom terminal.
2. Przejdź do folderu zawierającego plik aplikacji JavaScript za pomocą polecenia cd.
3. Zainicjuj npm następującym wierszem kodu:

npm początek -y

Istnieje jeden moduł npm, który będzie odgrywał kluczową rolę w funkcjonalności tej aplikacji. To jest moduł got, który jest biblioteką żądań HTTP dla NodeJS. Poniższy wiersz kodu zainstaluje najnowszą wersję biblioteki got w plikach aplikacji:

npm install dostał@latest

Teraz możesz śmiało budować swoją aplikację.

Korzystanie z biblioteki Got do tworzenia aplikacji

//zaimportuj bibliotekę got do swojej aplikacji
const dostał = wymagaj('dostał');
//pobierz dane z określonego interfejsu API REST i wypisz ich treść na terminalu
(async () => {
próbować {
const response = await got (URL);
const data = JSON.parse (response.body);
console.log (dane);
} złapać (błąd) {
console.log (błąd.dane);
}
})();

Powyższa aplikacja pobierze dane z dowolnego REST API w sieci. Jednak najpierw musisz podać adres URL odpowiedniego zasobu.

Pobieranie danych z interfejsu API Weather REST

Pogodabit.io API to jedna z bardziej popularnych pogody REST API. Wstawianie adresu URL tego API do prostej aplikacji JavaScript powyżej sprawi, że aplikacja będzie działać.

Korzystanie z interfejsu API REST Weatherbit.io

//zaimportuj bibliotekę got do swojej aplikacji
const dostał = wymagaj('dostał');
//pobierz dane z określonego interfejsu API REST i wypisz ich treść na terminalu
(async () => {
próbować {
stały adres URL = ' https://api.weatherbit.io/v2.0/current? lat=40.7128&lon=-74.0060&key=API_KEY';
const response = await got (URL);
const data = JSON.parse (response.body);
console.log (dane);
} złapać (błąd) {
console.log (błąd.dane);
}
})();

Adres URL Weatherbit.io API został pomyślnie wstawiony do aplikacji. Jest jednak jeden aspekt adresu URL, który musisz dostosować, aby uruchomić aplikację. Jest to sekcja oznaczona jako „API_KEY”, a ten klucz otrzymasz od Weatherbit.io po zarejestrowaniu darmowego konta.

Masz również możliwość dostosowania sekcji zapytania w powyższym kodzie. Aplikacja odpytuje obecnie pogodę na szerokości 40,7128 i długości -74.0060, ale można wstawić nowe współrzędne. Chociaż powyższe zapytanie jest zalecanym podejściem, możesz wyszukać pogodę w lokalizacji, używając nazwy miasta.

Aby uzyskać więcej informacji na temat korzystania z Weatherbit.io REST API, Kliknij tutaj.

Po wstawieniu API w odpowiedniej sekcji powyżej, możesz teraz uruchomić swój plik JavaScript. Aplikacja dostarczy coś podobnego do następującego wyjścia w twoim terminalu.

Przykład odpowiedzi interfejsu API REST Weatherbit.io

dane: [
{
prawe: 53,
strąk: 'd',
dł.: -74.01,
pres: 1005,9,
strefa czasowa: 'Ameryka/Nowy_Jork',
ob_time: '2021-09-27 14:50',
kod_kraju: 'USA',
chmury: 25,
ts: 1632754200,
rad_słoneczny: 652,8,
kod_stanu: 'Nowy',
city_name: 'Nowy Jork',
wind_spd: 5,66,
wind_cdir_full: 'zachód-południowy zachód',
wind_cdir: 'WSW',
slp: 1015,9,
widok: 5,
h_kąt: -30,
zachód słońca: '22:44',
dni: 851.72,
rosy: 12,
śnieg: 0,
UV: 5.68859,
opady: 0,
katalog_wiatr: 240,
wschód słońca: '10:49',
ghi: 657,55,
dhi: 106,79,
aqi: 53,
łac: 40,71,
pogoda: [Obiekt],
data i godzina: '2021-09-27:14',
temp: 22,
stacja: 'KJRB',
kąt wzniesienia: 40,89,
temp_aplikacji: 21,7
}
],
liczba: 1
}

Niektóre z ważniejszych aspektów danych zwróconych w odpowiedzi obejmują:

• Nazwa miasta (zwraca nazwę miasta na podanej długości i szerokości geograficznej).
• Data i godzina (zwraca aktualną godzinę cyklu w formacie RRRR-MM-DD: HH).
• Pogoda (zwraca obiekt zawierający ikonę pogody, kod pogody i opis tekstowy pogody).

Pobieranie danych z News REST API

Wiadomości API używany w tej sekcji to Newsdata.io. Jak wszyscy REST API w Internecie udostępnia kilka opcji zapytań, których można użyć do pobierania najświeższych wiadomości z całego świata. Z Newsdata.io API, możesz otrzymywać wiadomości z określonego kraju, języka, kategorii itd.

Za pomocą aplikacji JavaScript możesz pobierać dane z wiadomości REST API. Wystarczy zastąpić adres URL w powyższej aplikacji następującym adresem URL:

' https://newsdata.io/api/1/news? apikey=TWÓJ_KLUCZ_API&country=nas'

Następnym krokiem jest zastąpienie sekcji „TWÓJ_KLUCZ_API” w powyższym adresie URL słowem API klucz, który otrzymasz po zarejestrowaniu się w Newsdata.io. Powyższy adres URL zwróci najświeższe wiadomości z Ameryki. Jeśli jednak chcesz otrzymywać wiadomości z Japonii, możesz po prostu zamienić zapytanie „contry=us” na „country=jp”.

Aby uzyskać więcej informacji na temat korzystania z Newsdata.io REST API, Kliknij tutaj.

Związane z: Chcesz dodać nagłówki wiadomości do swojej witryny lub aplikacji? Potrzebujesz interfejsu API Mediastack

Przykład odpowiedzi Newsdata.io REST API

{
tytuł: „Kierowca zabity przy drzwiach własnego samochodu podczas oczekiwania w kolejce w Fast-Food Drive-Thru, dostarczający informacji ostrzegawczych dla samojezdnych samochodów 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/',
słowa kluczowe: [tablica],
twórca: [Tablica],
video_URL: brak,
opis: „Smutna historia o kierowcy, który został zabity przez drzwi jego własnego samochodu (podczas jazdy samochodem), dostarcza ostrzegawczych informacji na temat
pojawienie się autonomicznych samochodów opartych na sztucznej inteligencji. Oto spojrzenie poufnych.",
treść: „Smutna historia o kierowcy, który został zabity przez drzwi jego własnego samochodu (podczas jazdy samochodem), dostarcza ostrzegawczych informacji na temat
pojawienie się autonomicznych samochodów opartych na sztucznej inteligencji. Oto spojrzenie poufnych.",
Data publikacji: '2021-09-27 15:30:00',
image_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'
}

Używanie aplikacji Pythona do pobierania danych z różnych interfejsów API Rest

Możliwe jest pobranie danych dla Twojej witryny lub aplikacji za pomocą dowolnego języka programowania, który znasz. Tak więc, jeśli nie chcesz używać JavaScript, możesz osiągnąć te same wyniki za pomocą aplikacji w Pythonie.

Związane z: Jak budować interfejsy API w Pythonie: popularne frameworki

Wszystko, co musisz zrobić, to zainstalować moduł requestów HTTP python przy użyciu środowiska pip. Następnie możesz zbudować swoją aplikację w Pythonie, używając następującego kodu:

# zaimportuj bibliotekę żądań
żądania importu
# pobieranie danych za pomocą biblioteki żądań
URL = ' https://newsdata.io/api/1/sources? apikey=TWÓJ_KLUCZ_API=nas'
res = request.get (URL)
json = res.json()
dla klucza w json:
drukuj (klucz, json[klucz])

Podobnie jak w poprzednich przykładach, musisz wstawić swój API w odpowiedniej sekcji. Otrzymasz wtedy te same dane, które zwraca aplikacja JavaScript.

Pobieranie danych dla Twojej witryny lub aplikacji jest dość proste

Masz teraz narzędzia potrzebne do pobierania danych do aplikacji. Należy pamiętać, że ODPOCZYNEK architektura ułatwia luźne łączenie, co oznacza, że ​​możesz użyć dowolnego języka programowania, aby pobrać dane z dowolnego REST API w sieci.

Teraz wiesz, jak używać Reszta API, dlaczego nie spróbować?

Skrobanie stron internetowych a API: Jaki jest najlepszy sposób na wyodrębnienie danych?

Wszędzie są dane, ale zdobycie ich to inny problem — jeśli jest to nawet legalne.

Czytaj dalej

O autorze