Automatyzacja i AI w Biznesie i Marketingu: Wprowadzenie do API

0:02W tej lekcji opowiem Ci czym jest API.

0:04Z czego się składa API i pokrótce jak będziemy z tego wykorzystywać.

0:08Spokojnie, jeśli jesteś osobą nie tak techniczną, postaram się to

0:12wytłumaczyć na przykładzie.

0:13Akurat w tej lekcji na podstawie restauracji.

0:16W dalszych lekcjach będziemy już pokazywać na konkretnych przykładach

0:20tak właściwie jak to wykorzystywać, Co konkretne nazwy oznaczają, czym jest

0:23header, czym jest body i czym jest JSON?

0:26To już na spokojnie w lekcjach.

0:27Teraz chcę Ci zrobić taką.

0:29Takie wprowadzenie.

0:30Jak to w ogóle wygląda? Co to w ogóle jest?

0:32Zachęcam Cię też do dalszego zgłębiania czym jest w ogóle http

0:36zapytania i czym jest API.

0:38Znajdziesz również takie lekcje w przypadku.

0:40Akurat Grzesiek Róg nagrał taką lekcję na YouTubie, więc bardzo zachęcam Cię też

0:44do zgłębienia takiego takiej lekcji.

0:48A teraz Ci pokrótce przedstawię w ogóle jak możesz sobie wyobrazić czym jest API,

0:53a więc API, czyli tak właściwie Application Programming Interface.

0:56Jest to interfejs programowania aplikacji, czyli możemy sobie porównać do

1:00takiego kelnera w restauracji.

1:01Wyobraź sobie, że chcesz w restauracji zjeść posiłek, ale nie idziesz

1:04bezpośrednio do kuchni, aby powiedzieć kucharzowi, co chcesz zjeść.

1:07Zamiast tego dajesz to kelnerowi, który przekazuje je kucharzowi.

1:10Kucharz przygotowuje posiłek, a kelner przynosi to tobie.

1:13I w tym przykładzie Ty jesteś tym użytkownikiem danej aplikacji,

1:16czyli Ty wysyłasz to zapytanie.

1:19Kelner jest tym API, czyli pośrednikiem pomiędzy Tobą a kuchnią, a kuchnia jest

1:23jak system czy serwer, który działa w tle.

1:25Czyli Ty robisz zapytanie np.

1:27Klikając w table przycisk jeden konkretny, klikając Web Hook.

1:31Następnie API przekazuje to do serwera, czyli np.

1:35To idzie do.

1:36W tym momencie akurat dajmy na to dla przykładu Google Slights.

1:40Tam następnie dzieje się ta prezentacja, bo Ty jako użytkownik wysyłasz odpowiednie

1:44dane API, przesyła to zapytanie i w Google site tworzy się nasza

1:48prezentacja dla przykładu.

1:51Czyli już tak nie aluzyjnie, tylko tak dokładnie.

1:55Ty dokładnie klikasz jeden przycisk w majku akurat narzędziu, które będzie

1:59używać robi zapytanie do konkretnego serwera i ten serwer

2:02zwraca Ci tą odpowiedź.

2:03Czyli to, czyli to danie, które trafia odpowiednio do Ciebie.

2:06Przez to API, czyli przez tego kelnera, to danie musi do Ciebie wrócić.

2:09Kolejne dwie kwestie.

2:11Jest to header i body, czyli w kontekście API możemy dalej tak właściwie

2:15kontynuować analogię tej restauracji.

2:17Czyli header.

2:18Jest to kiedy składasz zamówienie w restauracji i podajesz kelnerowi te pewne

2:21informacje, no to mówisz czy masz alergie pokarmowe, preferencje dotyczące

2:26przypraw I znowu w API jest to samo.

2:28Przekazujesz informacje, metadane, czyli w jakim formacie akurat

2:31oczekujesz odpowiedzi. Czy to ma być JSON, czy to ma być XML.

2:34Zaraz zresztą do tego przejdziemy.

2:36Czym jest JSON, XML i tam podajesz informacje szczegółowe czy wysyłasz

2:39pdf a, czy wysyłasz Jasona?

2:41Tak, właściwie takie informacje około zamówieniowe.

2:44Tak, to nie jest konkret, czyli to, co wysyłasz, czyli te konkretne informacje

2:47czy to konkretnie dane danie, które wysyłasz, tylko to jest specyfika do tego.

2:54No i tak właściwie czym jest to body, czyli body, to jest to właściwe

2:57zamówienie, które składasz w restauracji.

2:59Ten konkretny posiłek, który chcesz zjeść.

3:01Body w tym kontekście to treść żądania lub odpowiedzi i ona zawiera konkretne dane.

3:07czyli my np.

3:08W body przesyłamy konkretne informacje, co ma się znaleźć w tej prezentacji,

3:11czyli że zmienna 1 ma wynosić np.

3:14Fotografię przedstawiającą żółwia.

3:17Zmienna druga ma np. Zawierać tekst.

3:20Ta oferta jest tylko dla Ciebie.

3:22Oraz inne rzeczy, które konkretnie chcesz przesłać do aplikacji,

3:25które ma dla Ciebie zrobić.

3:27Powiedziałbym o jeszcze dwóch najważniejszych tutaj

3:30metodach zapytania http.

3:32Są to zapytania, post i zapytania Get. Zapytania.

3:36Get.

3:36Jak sama nazwa wskazuje, chcemy otrzymać jakąś informację, a nie

3:39wysłać coś do naszego API.

3:42Czyli zapytujemy np.

3:43Table jakie ma konkretne wiersze?

3:45Zapytujemy Google slajdy jakie ma konkretnie po prostu prezentację, a

3:50zapytanie post służy do tego, żeby coś wysłać do danego API.

3:53Czyli na przykład jeżeli chcemy stworzyć daną prezentację, to użyjemy metody Post,

3:57żeby przesłać nasze dane, żeby Google slajd nam wrzuciło tą prezentację gotową.

4:04Czyli podsumowując header to informacje dodatkowe, które mówią jak

4:07obsłużyć Twoje zapytanie.

4:09zamówienie czyli bez glutenu lub extra pikantne, albo właśnie w jakim formacie

4:13chcesz otrzymać odpowiedź, albo w jakim formacie wysyłasz odpowiedź.

4:16A body to już tak właściwie treść tego gotowego zamówienia, czyli dokładnie to,

4:20co chcesz zjeść lub to, co dokładnie chcesz przesłać do API.

4:23JSON jest to format danych.

4:25Aktualnie widzisz na ekranie jak taki format danych może wyglądać.

4:29Widzisz właśnie, że mamy na przykład dane coś takiego jak imię, czyli imię Jan,

4:33czyli mamy klucz, imię i wartość Jan.

4:36I w takim formacie najczęściej będziemy posługiwać się, jeżeli będziemy

4:38wysyłać aktualnie zapytania.

4:40Jest również inna forma, dawniej używana, teraz też często akurat XML, ale w niej

4:46nie będziemy akurat działać w tym kursie.

4:48I tak jak widzisz dalej, to może zawierać zarówno liczby,

4:52zarówno tabele, zarówno jak i podlisty.

4:55Czyli jak mamy adres to mamy w tym ulicę, miasto, kod pocztowy, a jak mamy hobby to

4:59widać, że mamy też tabelę, którą zawiera 3 konkretne rzeczy o naszym hobby.

5:06Czyli teraz wiesz czym są hedery, czym jest body?

5:09Czyli tak właściwie teraz musimy wiedzieć, do kogo mamy zapytać,

5:13czyli czym jest endpoint?

5:14Endpoint to miejsce po prostu jakbyś podglądał.

5:17Na przykład. URL, czyli facebook.

5:19com. Slash.

5:20I tutaj tak właściwie robimy kolejne zapytania.

5:23Czyli możemy na przykład.

5:24Najczęściej jest wersja dokumentacji API, czyli v1, v2, następnie kolejny slash

5:29i wtedy robimy już metodę zapytań.

5:31Czyli na przykład w przypadku Airtable mamy tworzenie nowego wiersza, czyli to

5:36będzie slash v1, slash, create new row.

5:39Akurat tak nie jest dokładnie w r table, ale pokażę Ci to po prostu na przykładzie.

5:44Następnie mamy kolejną, czyli Slash get row.

5:47Czyli chcemy chcemy dowiedzieć się jak wygląda konkretny wiersz

5:52i jakie są konkretne dane.

5:53Ale do tego parametru możemy dodać znak zapytania.

5:57I tak jak widzisz aktualnie na ekranie mamy na przykład ID równa się i podajemy

6:02jakiś numer ID, bo chcemy otrzymać zapytanie o konkretne ID, o konkretny

6:08wiersz i dowiedzieć się jak to wygląda.

6:09Możesz to zrobić w query stringu, czyli tak jak teraz widzisz na adresie URL.

6:13I to są tak zwane query string query parametry.

6:15Albo możesz zrobić to w body, czyli otwieramy nawias wstążkowy, wpisujemy

6:21sobie cudzysłów id, dwukropek i znowu cudzysłów.

6:24Otwieramy i wpisujemy konkretne ID tak jak widzisz na ekranie.

6:27I tak wygląda zapytanie query.

6:29A tak wygląda zapytanie w formacie JSON w body.

6:33Ale jedno i drugie zaczytuje się do konkretnego endpoint, do konkretnego

6:37URL danej strony danego serwera.

6:40Zaraz Ci pokażę na przykładzie dokumentację Pipedrive.

6:43Czym konkretnie są endpoint?

6:45Czym konkretnie są query? Parametry.

6:48Dobra, przejdźmy zatem do ekranu.

6:50Więc tak jak widzisz mamy tutaj akurat dokumentację Pipedrive i tak

6:54jak mówiłem są endpointy.

6:55Mamy jedno główne zapytanie, czyli tutaj w tym przypadku akurat

7:00jest to adres Pipedrive.

7:02Po prostu możemy z niego skorzystać i tak jak mówiłem są slash, czyli

7:05slash v1 i activities.

7:07Następnie, jeżeli przejdziemy sobie do kolejnego zapytania, czyli get all

7:11activities, to tak jak widzisz V1.

7:12Kolejne tak właściwie zapytanie, czyli ten adres URL, do którego się zapytujesz

7:18odpowiada konkretnej metodzie.

7:20I tak jak widzisz, tu mamy wszystkie aktywności Get.

7:22Tutaj mamy akurat dodanie nowej aktywności i znowu mamy post.

7:26Czyli jeżeli dodajemy aktywność, to używamy metody post.

7:28Jeżeli chcemy coś wyciągnąć, czyli zagotować, po prostu używamy metody Get.

7:33Zachęcam Cię do zgłębienia innych metod, bo tak właściwie tu Ci podałem przykładowe

7:36bo tak jak widzisz są put, delete, patch oraz inne metody I jeżeli chcesz zgłębić

7:40ten temat, bardziej zainteresować się tym, to bardzo zachęcam do do sprawdzenia.

7:45I tak jak widzicie jest body parameters, czyli są tak właściwie if application json

7:49jest jaka jest date, jaki jest def time i konkretne rzeczy, które są do tego

7:55potrzebne, aby taką aktywność stworzyć.

7:58Ale widzisz, jeżeli chcesz wygenerować coś, to na przykład możesz to zrobić w

8:02Parameters, czyli tak jak aktualnie na ekranie Ci pokazuje.

8:05Możesz zrobić znak zapytania.

8:08UserID równa się i wprowadzić swój userID, więc w tym momencie wiesz

8:12jak wygląda endpoint.

8:13Wiesz jakie zapytanie chcę złożyć, więc przejdźmy do make i stwórzmy

8:16przykładowe zapytanie.

8:18Czyli teraz wiesz już jak wygląda zapytanie, jak wygląda endpoint?

8:22Więc na przykładzie.

8:24Teraz pokażę Ci jak wygląda konkretne zapytanie http.

8:28Widzisz aktualnie na ekranie bank API, które akurat bardzo lubię do tłumaczenia

8:33jak działa API, więc mamy główny endpoint do którego się odnosimy, czyli

8:37tutaj mamy API Bank API .

8:39com v2 wersja i następnie mamy parametry.

8:42Tak jak widzisz, akurat tu zapytujemy o piwo i następnie

8:46zapytujemy znak zapytania.

8:47Tak jak Ci wcześniej tłumaczyłem mamy, że zostały przed zostały jakby wyważone, bo

8:53to jest warzenie w piwie akurat przed 11, czyli listopadem 2012 oraz inny parametr

9:00akurat zaraz zobaczymy jaki to odpowiada.

9:02Mamy paginację, czyli możemy jakby znowu używać page, czyli żebyśmy nie otrzymali

9:0710 tysięcy rekordów naraz, tylko na przykład z defaultu.

9:10Tak jak widzisz, jest podane 25 w zapytaniu.

9:14Czyli teraz weźmy sobie Get birth.

9:16Zapytajmy po prostu bez żadnego parametru, jak wygląda lista.

9:21Bierzemy sobie moduł HTTP.

9:25Bierzemy sobie moduł HTTP.

9:28Wybieramy go. Robimy sobie make request.

9:33Wrzucamy to. Klikamy OK.

9:35Dla dokumentacji możemy jeszcze sprawdzić jaka to jest metoda.

9:38Tak jak tutaj akurat jest metoda Get.

9:42I odpalamy. Zobaczmy co nam poda.

9:45Ok. Możemy sobie zobaczyć już jak to wygląda.

9:47Zapytanie i mamy data.

9:48Tutaj tak jak widzisz mamy podane to w formacie JSON, ale on nie jest tak

9:53właściwie sformatowany, tak żebyśmy mogli to spokojnie przeczytać.

9:56Więc wróćmy do tego i kliknijmy sobie Parse response.

10:02Kliknijmy jeszcze raz.

10:04Dała nam odpowiedź.

10:05Teraz mamy data.

10:06I teraz tak jak widzisz, mamy konkretnie 25 odpowiedzi, czyli tak

10:10jak dokumentacja nam mówiła.

10:12Przeglądamy sobie pierwszą odpowiedź i mamy jakie to jest ID.

10:14ID 1 nazwa tego piwa tak Read better.

10:18I tak jak widzisz, mamy tutaj możliwość wykorzystywania ich dalej.

10:21Jeżeli byśmy chcieli to wrzucić do RTB czy jakiejkolwiek innej tabeli,

10:25cokolwiek z tym robić.

10:26Więc teraz tak, mamy to zapytanie ogólne, czyli mamy.

10:29Mamy te piwa, ale chcemy dowiedzieć się więcej, bo zależy nam na konkretnym np.

10:34Tutaj akurat AbV czy IBU.

10:37Czyli mamy parametry AbV, IBU tak właściwie i tutaj rzeczy,

10:41które możemy skorzystać.

10:42My skorzystajmy z tego przykładowego parametru, czyli tak jak tutaj mamy, jest

10:48ten dokładny endpoint, jest ten pierwszy endpoint, tak jak tutaj

10:51widzisz route endpoint.

10:52Następnie mamy jaką metodę, czyli my akurat zapisujemy piwo, mamy znak

10:56zapytania, czyli to w query stringu.

10:57To są rzeczy, które chcemy mieć wymagane, czyli zostaną wyważone przed 11

11:02listopada i AbV GT jest równe 6.

11:05Możemy sobie to skopiować spokojnie i wrzucić i zobaczymy czy da nam inny wynik.

11:10Klikamy OK data i tak jak widzisz mamy już ID 5, czyli mamy inne wyfiltrowane rzeczy

11:19niż tak właściwie po kolei od 1 2 3 4 5.

11:22Oczywiście możemy tutaj zakładać takie filtry, jakie chcemy.

11:26Tak właściwie takie metody zapytania już jakie chcemy tutaj odpowiednio.

11:30Tak jak widzisz, możesz sobie z nich korzystać.

11:32Teraz chcę Ci pokazać jeszcze jedną metodę, czyli możemy tutaj akurat zapytać

11:38o jedno konkretne piwo albo jedno randomowe piwo.

11:42Czyli tutaj mamy birth slash random, czyli to jest kolejna metoda

11:46zapytania, tak właściwie.

11:48Więc zapytajmy się o to.

11:51Tak jak widzisz, to jest całkowicie inny endpoint.

11:54I sprawdźmy, czy teraz rzeczywiście poda nam pojedyncze piwo.

11:58I tak jak widzisz podało nam ID 1, bo to jest pierwsze na liście, kiedy zapytujemy,

12:03ponieważ nie daliśmy żadnego query zapytania, czyli wyrzuca

12:05nam po prostu pierwsze piwo.

12:07Mam nadzieję, że już rozjaśniłem Ci na czym to polega właśnie w takiej aluzji

12:11bardziej restauracyjnej, w takim klimacie właśnie, żeby to łatwo było po

12:16prostu strawić, że tak to ujmę.

12:19I po prostu mam nadzieję, że będziemy widzieć się w dalszych lekcjach i już

12:23będziesz w praktyce wykorzystywał API.

12:25Dzięki Ci za tą lekcję i zapraszam do kolejnej.