HTTP i API: Wprowadzenie do API

0:02Cześć, witaj w kolejnej lekcji.

0:03Wiesz już naprawdę dużo o protokole HTTP,

0:05więc możemy przejść do API, czyli Application Programming Interface, czyli

0:10do czegoś na czym działa w zasadzie cały internet.

0:14Kiedyś, kiedyś dawno temu wystarczała taka architektura, gdzie mieliśmy jeden serwer,

0:19jednego klienta, czyli mnie z przeglądarką,

0:22ja wpisywałem sobie adres np.

0:23google.com to leciało do serwera i tam

0:26działa się cała magia i to do mnie wracało.

0:28Problem niestety polega na tym, że w

0:30obecnych czasach mamy masę urządzeń, mamy masę takich

0:35możliwości korzystania z różnych aplikacji, które dają nam dostęp do tych

0:40samych zasobów, do tych samych danych, a zarazem do tego samego serwera.

0:44Weź np. aplikację banku.

0:46Ta aplikacja banku oczywiście jest na

0:48jednym centralnym serwerze, który potrafi wyliczyć Twoje saldo na koncie.

0:52No ale teraz Ty możesz łączyć się do niej albo z klienta,

0:57którym jest przeglądarka na komputerze, ale możesz też połączyć się z aplikacji

1:00mobilnej, ale prawdopodobnie do Twojego konta

1:03może też połączyć się jakaś osoba z

1:06administracji banku, być może jakąś inną aplikacją, ich CRM itd itd.

1:10W związku z tym wszystkie te aplikacje komunikują się w pewien sposób z

1:14serwerem i dzieje się to właśnie przez API.

1:18API nie jest niczym innym jak tym naszym

1:21protokołem HTTP, tylko w pewien sposób ustrukturyzowanym. Więc bazuje to na

1:25protokole HTTP i pozwala mieć jedną logikę biznesową, czyli jeden serwer, który

1:31wylicza te wszystkie dane na kontach i dodatkowo wszyscy mogą się z nim łączyć

1:37w pewien ustrukturyzowany sposób pytając o różne dane.

1:40Akurat banki oczywiście tego nie robią, żeby udostępniać dane losowym osobom, ale

1:44generalnie jeśli wymyślili byśmy sobie, że my zrobimy aplikację jakiegoś sprytnego

1:49portfela, który zarządzał by naszymi wydatkami, no to musielibyśmy się np.

1:54połączyć z API banku po to,

1:57żebyśmy mogli odczytać całą historię wydatków danego klienta.

2:01Jeżeli bank udostępniał by nam takie API

2:04moglibyśmy z pomocą odpowiednich metod GET, POST itd.

2:08np.

2:08z pomocą GET odebrać te dane i zbudować sobie na nich naszą własną aplikację.

2:13Czyli w tym momencie

2:15w zasadzie jeśli jakiś serwis nie ma API to praktycznie nie istnieje.

2:20Bardzo często będziemy łączyć się z różnymi serwisami i tak naprawdę można

2:24teraz powiedzieć, że samemu nie musimy tworzyć dużej ilości danych.

2:28Możemy po prostu podpiąć się pod

2:29odpowiednie dane i stworzyć sobie ich wersję.

2:33Czyli np.

2:34jeżeli chcielibyśmy korzystać z danych pogodowych nie ma problemu.

2:37Jest masa API, które wystawiają nam

2:39informacje o aktualnej pogodzie w różnych miejscach na świecie.

2:42Następnie mamy API, które powiedzmy Food & Drink.

2:45Zobaczmy i zobaczmy np.

2:49PUNK API i jego dokumentację. Zobacz, że

2:54mamy taki główny tzw.

2:56endpoint i to jest pierwsze ważne słowo,

2:59na które skoro już na nie trafiamy to je wytłumaczmy.

3:03Endpoint to jest generalnie tzw.

3:05końcówka, czyli końcówka w sumie adresu URL, do której będziemy się odwoływać.

3:12Endpoint jest takim technicznym

3:13sformułowaniem w kontekście tego, jak API są tworzone, ponieważ jeśli np.

3:17mielibyśmy klientów, to mielibyśmy przykładowo endpoint clients.

3:21Gdy mielibyśmy ich zamówienia to mielibyśmy endpoint clients/orders np.

3:27coś takiego. Więc to jest ten pierwszy endpoint, czyli

3:29po prostu taki adres URL i jego końcówka, pod którą będziemy się łączyć.

3:33Następnie mamy

3:36poszczególne polecenia curl, czyli poszczególne, te konkretne endpointy,

3:41do których możemy się łączyć po to, żeby odebrać sobie różne rzeczy, np.

3:45weźmy piwo, czyli mamy tutaj adres, który zwróci nam informacje o różnych piwach

3:51prawdopodobnie. Jeśli byśmy go otworzyli w

3:53ten sposób w przeglądarce i mamy zainstalowany ten dodatek, który nam

3:57zwróconego przez serwer JSON ładnie sparsuje, ładnie wyświetli, no to zobacz, że

4:03generalnie w odpowiedzi na takie zapytanie o to piwo jeszcze raz sobie je wykonajmy.

4:08Przejdźmy do Network.

4:09Będziemy mieli właśnie dokładnie tą odpowiedź Response

4:13tyle, że w przeglądarce

4:14tutaj nie wygląda to zbyt ładnie, a jako, że mam ten dodatek to widzimy, że mamy

4:19różne nazwy piw, kiedy zostały wyprodukowane, ich opisy, a nawet obrazki.

4:24Jeżeli klikniemy sobie w taki obrazek,

4:26będziemy mogli zobaczyć obrazek danego konkretnego piwa.

4:29Więc na tym możemy już zacząć budować sobie jakąś aplikację.

4:32Korzystając z tych danych będziemy mogli np.

4:35wyświetlać je u nas.

4:36Naturalnie musielibyśmy w pewien sposób je przefiltrować.

4:39Czyli jeśli chodzi o np. piwa, chcielibyśmy

4:42dostać powiedzmy jakieś konkretne na jakieś właściwe zapytanie i zobacz, że

4:47to się akurat w tym API odbywa przez te parametry, o których Ci wspomniałem.

4:51Czyli mamy tutaj listę parametrów, które będą nam zwracać odpowiednie rzeczy.

4:56Możemy też dostać jakieś pojedyncze piwo, które jest pod jakimś indeksem.

5:02Czyli jeśli chcielibyśmy wyświetlić tylko takie konkretne piwo, możemy to skopiować,

5:06ale tak jak powiedziałem, jeżeli chcemy zawęzić wyniki wyszukiwania, to część API

5:10jest przygotowana w ten sposób, że możemy to zrobić z pomocą parametru.

5:15I teraz np. możemy wyświetlić sobie tylko piwa malt

5:18albo tylko piwa hops, albo poszukać piwa po jakiejś konkretnej nazwie.

5:24Tutaj mamy też przykład konstruowania takiego parametru

5:30i możemy sobie to skopiować i to nam wyświetli wszystkie piwa,

5:35które zostały uwarzone przed 2012 rokiem.

5:39Jeszcze jakiś dodatkowy tu jest parametr, który możemy sobie go wyszukać w

5:43dokumentacji i zobaczyć, co on robi abv_ gt.

5:46Zwraca nam wszystkie piwa abv większe niż ten jakiś numer.

5:53Dobra, nie wiem co to do końca jest, ale zawsze w API się to znajdzie

5:58i zobacz, że taki wynik tutaj otrzymujemy

6:01i jest tych wyników już zdecydowanie mniej, ale za to są te, które są przed 2012.

6:06Jak byśmy tutaj dali 15, to odpowiednio nasze wyniki byłyby zawężone.

6:11W ten sposób możemy się do API dobrać,

6:13no i naturalnie nie będziemy tego robili

6:15po to, żeby ten JSON nam został zwrócony w przeglądarce, tak jak ja tutaj robię,

6:19tylko będziemy chcieli te dane odebrać i mając je np.

6:23robiąc to z pomocą jakiegoś JavaScript u nas

6:25na stronie będziemy mogli wyświetlić sobie odpowiednio nazwę, tagline, opis tego piwa i

6:32generalnie tak, w ten sposób właśnie działa cały internet.

6:36Część serwerowa przygotowuje dla nas tą

6:38całą logikę i wystawia nam ją w postaci tych tzw.

6:41endpointów, czyli przez API.

6:43My do tych endpointów jako np.

6:46front-end developerzy łączymy się, bierzemy dane, które chcemy,

6:49najczęściej potrafimy w nich też wyszukiwać z pomocą

6:52właśnie tych query stringów lub w inny sposób, a później jakoś je formatujemy i

6:57wyświetlamy już na naszej właściwej witrynie.

6:59Więc tych dostępnych publicznie API jest masa.

7:03Tu jest ich jakaś przykładowa lista,

7:05ale mamy też jakieś jak widzisz API z przepisami

7:09i tutaj również możemy jak widzisz

7:12sformułować sobie takie proste zapytanie gdzie dostajemy przepis po

7:17po prostu zapytaniu ingredients czyli i, możemy tutaj podać

7:22różne składniki, czyli możemy przykładowo podać cebulę i czosnek, onions, garlic,

7:27pewnie możemy wpisać też mushrooms i coś takiego

7:31i jeszcze żeby query nam pasowało do omletu

7:35to jest chyba jakaś paginacja, ale możemy to po prostu sprawdzić w ten sposób.

7:39I zobacz, że dostaliśmy kilka przepisów

7:42z informacjami o tym jaki to jest omlet, z czego się składa, jakie są przepisy,

7:46a nawet link do tego omletu i niektóre nawet mają zdjęcia.

7:50Zobacz, że mamy obrazki, które możemy

7:52tutaj obejrzeć i gdybyśmy robili aplikację np.

7:55mobilną, ta aplikacja mogłaby korzystać z takiego API,

7:59przykładowo wyświetlać przepisy a my byśmy mogli tylko dorobić logikę, która pozwala

8:03nam jakoś fajnie te przepisy filtrować, jakoś je pokazywać itd.

8:09Więc w ten sposób to działa

8:10jeśli chodzi o odczytywanie danych z rozmaitych API.

8:13Natomiast tak jak powiedziałem, wszystkie współczesne serwisy mają jakieś API

8:18dostępne czy jest to Facebook, czy Twitter, czy Google, czy YouTube i tak

8:21dalej, możemy dostać się do tych danych programistycznie właśnie z pomocą API,

8:25natomiast korzystanie z nich jest już

8:27trochę bardziej trudniejsze niż z tych np. przepisów, które Ci pokazałem

8:31i nie możemy co do zasady tak o po prostu

8:33wkleić sobie jakiegoś adresu, ponieważ te API są w pewien sposób zabezpieczone.

8:38O tym porozmawiamy w kolejnej lekcji.