HTTP i API: Uporządkowanie pojęć

0:02Cześć,

0:02witaj w ostatniej lekcji tego

0:03kursu, w której chciałbym trochę podsumować to co zrobiliśmy i

0:06przypomnieć Ci, ale także rozszerzyć Twoją wiedzę o te najważniejsze sformułowania w

0:11kontekście pracy z API oraz z protokołem HTTP. Protokół,

0:15już wiesz co to jest

0:17te określone reguły, które służą do komunikacji, HTTP

0:20coś, na czym oparty jest cały Internet.

0:23Dwa kluczowe pojęcia, które tutaj mieliśmy

0:25to serwer oraz klient, gdzie serwer jest tym naszym komputerem, który gdzieś stoi i

0:30trzyma wszystkie informacje, działa 24/7, do którego dobijają się klienci, czyli

0:35wysyłają rozmaite zapytania, czyli tzw.

0:38request. Mówiliśmy o tym, jaka jest struktura

0:42request z zapytaniem, że powinien on zawierać metodę, czyli np.

0:46GET, POST albo PATH czy PUT, żeby np.

0:49modyfikować istniejące dane czy DELETE żeby usuwać istniejące dane.

0:53Kolejno mamy nazwę, czy mamy kolejną wersję protokołu, którą się komunikujemy,

1:00no i mamy również możliwość wysłania tam nagłówków czy argumentów,

1:05w odpowiedzi od serwera z kolei dostajemy tzw.

1:08response, który też ma swoje odpowiednie

1:10nagłówki, ale przede wszystkim body, czyli treść tego response,

1:13no i kod statusu, który informuje nas, że albo wszystko się udało, albo np.

1:19serwerowi nie udało się zrealizować

1:21naszego żądania czy to z powodu błędu klienta np.

1:24404, że nie ma takiego zasobu albo z powodu błędu błędu serwera,

1:29czyli te mogą być 5 setki.

1:31Kolejno mamy różne właściwości tej składni naszego JSON, o którym rozmawialiśmy.

1:38Mieliśmy albo XML, albo JSON.

1:40Jeżeli będziesz słyszał o czymś takim jak API np.

1:45REST, REST API albo SOAP API

1:48generalnie jest to po prostu nadbudowa tego, o czym rozmawialiśmy.

1:51O to, że są jakieś konkretne reguły dotyczące tworzenia właściwych endpointów,

1:57nazywania ich, tworzenie tam liczby mnogiej czy pojedynczej

2:01i właśnie to określa się np.

2:03resetem w odniesieniu do takich API, które są tworzone głównie na JSON.

2:08Natomiast API SOAP będzie z kolei zestawem reguł nawet trochę bardziej restrykcyjnym

2:13dotyczącym samej architektury i tworzenia API opartego na XML.

2:17W związku z tym jest to jakby kolejna warstwa, na co programiści się umówili,

2:21jak będą tworzyć te API tak żeby one były dosyć intuicyjne chociaż mimo wszystko

2:26będzie potrzebna na pewno lektura dokumentacji.

2:29Jeśli chodzi o samego JSON, to pamiętaj, że mieliśmy tam też tablice,

2:33tablice asocjacyjne, tablice zawierające różne elementy,

2:35tam były składniki do pizzy, ale mogliśmy mieć też obiekty takie jak np.

2:40cały użytkownik, którego mogliśmy w ten sposób tworzyć albo np.

2:43aktualizować.

2:45Mieliśmy też proste pary klucz wartość.

2:48Jeżeli były one dodane w adresie URL tworzyły tak zwany query string,

2:53czyli mogliśmy w ten sposób też przekazać jakieś dane do serwera.

2:58Czym się różnią te query stringi, czyli te tzw.

3:01argumenty, te parametry, które przekazujemy od np.

3:05nagłówków,

3:06w zasadzie technicznych różnic trochę jest, ale w sumie nagłówki

3:09pamiętaj, że są to te metadane, które

3:11dostaje od nas serwer, jakieś meta informacje niewidoczne dla użytkownika,

3:16natomiast w samych parametrach będziemy przekazywać te właściwe dane, podobne do

3:21tych, które przekazujemy w samej treści, czyli w body takiego zapytania.

3:27Jeżeli takie zapytanie jest krótkie np.

3:29chcemy wygenerować proste zamówienie i chcemy przekazać imię, nazwisko i rodzaj

3:32zamówienia, to te trzy rzeczy moglibyśmy łatwo przekazać w query stringu też jako te

3:37właściwe dane dla serwera, na podstawie którego on wygenerował by np.

3:41jakąś fakturę albo stworzył jakieś zamówienie.

3:43Następnie mamy autentykację, czyli proces, w którym klient dostarcza

3:50swoją tożsamość do serwera i w tym mamy credentiale tak zwane,

3:55czyli takie te sekretne części informacji takie jak hasło czy np.

3:59nazwa użytkownika, jak również różne rodzaje autentykacji, czyli np.

4:03tą podstawową loginem i hasłem.

4:05Ale też mówiliśmy o oAUTH w wersji 1, 2, gdzie mieliśmy te sekretne klucze i ta

4:10komunikacja była tam trochę trudniejsza, bo wymagała różnych odpowiedzi.

4:13Nie wchodziliśmy za mocno w szczegóły, ale

4:15chciałem, żebyś znał te podstawowe terminy.

4:18W wyniku takiej bardziej złożonej autentykacji użytkownika, gdzie wymieniane

4:21są różne dane, jakieś sekretne klucze, czy np.

4:25wysyłany jest jakiś access token, czyli właśnie taki token, który kawałek kodu,

4:31który pozwala na zautoryzowanie się w aplikacji, ale jednocześnie te bardziej

4:34skomplikowane formy autentykacji umożliwiają też operowanie czymś takim, co

4:38nazywa się scope, czyli powiedzmy jakiś zakres, na którym dany

4:42użytkownik może dokonywać zmian, modyfikacji i tak dalej.

4:45W ten sposób możemy dla konkretnych

4:47użytkowników czy dla konkretnych osób, które się u nas autoryzują w jakiś

4:52sposób zawęzić dostęp do pewnych informacji, np.

4:55uniemożliwić osobom niepowołanym usuwanie rekordów z naszej bazy.

4:59Kolejno mamy coś takiego jak zasób. Może to być jakiś

5:02obiekt. Najczęściej to jest rzeczownik, czyli np.

5:04jakieś zamówienie albo jakiś konkretny klient, do którego możemy się dostać.

5:08I często mówiąc o endpointach, czyli tych

5:11konkretnych adresach URL, które funkcjonują w ramach naszego API

5:15jeśli np. weźmiemy API REST, to takim endpointem

5:18będzie właśnie najczęściej zasób, czyli ten adres URL będzie kierował np.

5:21do konkretnej osoby czy do konkretnego zamówienia, które mamy.

5:25Kolejno mamy coś takiego jak Pooling i Long Pooling oraz Webhooks, czyli te metody

5:31dostępu do danych Poling, gdzie było to cały czas odpytywanie.

5:35W przypadku np.

5:36Ubera mało efektywne

5:37jeżeli ktoś stoi na skrzyżowaniu a my marnujemy zasoby serwera.

5:41Później było Long Pooling trochę bardziej wydajne, no i w końcu Webhooks, gdzie

5:44powiedziałem Ci, że klient jednocześnie może być jakby serwerem, czyli dostaje ten

5:48swój endpoint, z którym może się serwer komunikować.

5:51I to jest tak naprawdę wszystko, co

5:53chciałem powiedzieć Ci w tym kursie i w tej lekcji.

5:55Mam nadzieję, że nauczyłeś się czegoś pożytecznego.

5:58Do usłyszenia w kolejnych materiałach.