Co to jest API i jak działa?
API (Application Programming Interface) to ustalony sposób komunikacji pomiędzy systemami lub częściami programu. Pozwala im wymieniać informacje i zlecać określone działania według wcześniej ustalonych zasad.
Każdego dnia korzystamy z aplikacji i usług, które wykorzystują API.
Wyobraź sobie, że zamawiasz produkt w sklepie internetowym. Po kilku minutach otrzymujesz potwierdzenie płatności, a następnego dnia numer przesyłki. Za kulisami kilka różnych systemów wymienia między sobą informacje.
Żeby taka wymiana była możliwa, systemy potrzebują wspólnych zasad komunikacji. Jednym z mechanizmów umożliwiających taką komunikację jest API.
Choć API działa w tle wielu aplikacji i usług, niewiele osób zastanawia się, co to jest API i dlaczego odgrywa tak ważną rolę.
Kiedy zaczynałam pracę w IT, długo nie rozumiałam, co to jest API i dlaczego tak często pojawia się w rozmowach o systemach. Z czasem zauważyłam jednak, że spotykam je niemal codziennie.
Co to jest API?
Najprościej można powiedzieć, że API pozwala systemom wymieniać informacje i zlecać określone działania według wcześniej ustalonych zasad.
API nie jest całym procesem biznesowym. Określa, w jaki sposób jeden system może poprosić drugi o dane albo wykonanie określonego działania. To, co wydarzy się po otrzymaniu komunikatu, zależy już od logiki systemu obsługującego API.
Dobrym przykładem jest aplikacja pogodowa. Kiedy sprawdzam prognozę na telefonie, aplikacja nie mierzy temperatury samodzielnie. Wysyła pytanie do zewnętrznego serwisu i odbiera odpowiedź z aktualnymi danymi. Taki komunikat często nazywa się żądaniem (request), a zwracany rezultat odpowiedzią (response). Te nazwy opisują typowy sposób działania wielu internetowych API.
Jak działa API?
Kiedy patrzę na działanie API, widzę przede wszystkim uporządkowaną wymianę informacji. Choć od strony technicznej za taką komunikacją kryje się wiele mechanizmów, sama logika jest zaskakująco prosta.
Komunikacja między systemami czasem trwa bardzo krótko, a czasem może wymagać dłuższego przetwarzania. Z perspektywy użytkownika wygląda to często jak zwykłe odświeżenie ekranu albo pojawienie się nowego statusu. W tle dzieje się jednak kilka kroków, które pozwalają przekazać informację w uporządkowany sposób.
Od czego zaczyna się działanie API?
Jeden system potrzebuje danych albo chce zlecić wykonanie określonego działania. Może chodzić o pobranie statusu zamówienia, zapisanie zmiany, sprawdzenie dostępności produktu albo uruchomienie innej operacji. System wysyła żądanie w ustalonej wcześniej formie, dlatego po drugiej stronie nie trzeba domyślać się jego znaczenia.
Jak API sprawdza otrzymane żądanie?
Po otrzymaniu żądania system sprawdza jego formę i rozpoznaje, jakiej operacji ono dotyczy. Może to być prośba o odczytanie danych, zapisanie zmiany albo wykonanie określonego działania. Jeżeli dostęp jest chroniony, system sprawdza również wymagane poświadczenia i uprawnienia.
Jednym z prostszych sposobów rozpoznania aplikacji wysyłającej żądanie jest klucz API (API Key), czyli specjalna wartość dołączana do komunikacji. Może pomagać określić, która aplikacja lub usługa korzysta z API, zastosować odpowiednie limity i sprawdzić, czy dane wywołanie jest dozwolone. Klucz API nie musi jednak potwierdzać tożsamości konkretnego człowieka.
Użytkownik nie widzi tych sprawdzeń. System może tu również zastosować inne mechanizmy chroniące wymianę danych.
W internetowych API miejsce, pod które trafia żądanie, często nazywa się endpointem. Można myśleć o nim jak o konkretnym adresie, pod którym system obsługuje określony rodzaj pytań lub działań.
Jak API zwraca odpowiedź (response)?
System zwraca odpowiedź zawierającą informację o wyniku żądania. Może ona zawierać dane, potwierdzenie wykonania operacji albo opis błędu. Czasem odpowiedź nie zawiera dodatkowej treści, a o wyniku informuje jej status.
W wielu współczesnych rozwiązaniach dane przesyłane są w formacie JSON (JavaScript Object Notation). Mimo technicznej nazwy jest to po prostu uporządkowany sposób zapisywania informacji, który potrafią odczytać różne aplikacje.
Jak informacja trafia do kolejnego etapu procesu?
Na końcu informacja trafia tam, gdzie jest potrzebna. Może pojawić się na ekranie, zostać zapisana w bazie danych albo przejść do kolejnego etapu procesu.
API określa, jak systemy wymieniają dane lub zlecają działania. Proces biznesowy określa, po co dana operacja jest wykonywana i co powinno wydarzyć się dalej. Samo przesłanie danych nie oznacza jeszcze, że odbiorca otrzyma użyteczną informację. O różnicy między danymi a informacją przeczytasz więcej w artykule Skąd wiadomo, czy to dane, czy informacje?
Pamiętam sytuację, w której zamówienie wyglądało poprawnie w jednym systemie, a w drugim jakby nie istniało. Żeby znaleźć przyczynę, wystarczyło sprawdzić, czy żądanie zostało wysłane, czy dotarło do drugiego systemu i jaką odpowiedź zwrócił.
Jakie są rodzaje API i dlaczego istnieje ich tak wiele?
Kiedy zaczynamy rozumieć, co to jest API, szybko okazuje się, że nie wszystkie API działają w identyczny sposób. Różne systemy komunikują się z różnych powodów i w różnych warunkach. Choć wszystkie API służą uporządkowanej komunikacji, różnią się przeznaczeniem, sposobem działania i gronem odbiorców.
API publiczne, partnerskie i wewnętrzne
Wyobraźmy sobie informację, która chce opuścić system.
Czasami API jest udostępniane zewnętrznym programistom i aplikacjom. Tak działają API publiczne. Dostęp może podlegać ograniczeniom . Usługa może wymagać rejestracji, klucza API albo przestrzegania określonych limitów.
Czasami informacja powinna trafić tylko do wybranych organizacji. Wtedy wykorzystywane są API partnerskie (Partner API). Można je spotkać na przykład pomiędzy sklepem internetowym i firmą kurierską albo pomiędzy bankiem i operatorem płatności. Informacja nie jest publiczna, ale może być wymieniana pomiędzy zaufanymi partnerami.
W wielu sytuacjach informacja wcale nie opuszcza organizacji. Przemieszcza się pomiędzy systemami działającymi wewnątrz jednej firmy. W takiej sytuacji wykorzystywane są API wewnętrzne (Internal API lub Private API). Dzięki nim system sprzedażowy może komunikować się z magazynem, magazyn z logistyką, bez konieczności ręcznego przepisywania danych.
Kiedy spojrzymy na to z tej perspektywy, zauważymy, że różne informacje mają różne grono odbiorców. Jedne mogą być dostępne publicznie, inne wyłącznie dla partnerów, a jeszcze inne powinny pozostać wewnątrz organizacji.
Wiele firm korzysta z kilku wyspecjalizowanych systemów, które muszą ze sobą współpracować. API pozwala tworzyć pomiędzy nimi uporządkowane połączenia. To właśnie dlatego API stało się jednym z fundamentów współczesnej technologii. Nie dlatego, że jest modne. Dlatego, że pozwala łączyć aplikacje, dane i procesy.
REST API, SOAP i GraphQL – czy trzeba je znać?
Jeżeli będziesz kiedyś przeglądać dokumentację techniczną, spotkasz tam nazwy takie jak REST API (Representational State Transfer), SOAP (Simple Object Access Protocol) czy GraphQL.
Nazwy REST, SOAP i GraphQL odnoszą się do różnych podejść wykorzystywanych przy tworzeniu API. REST jest stylem projektowania, SOAP protokołem komunikacyjnym, a GraphQL językiem zapytań dla API.
Do zrozumienia podstaw działania API nie trzeba zapamiętywać tych różnic.
Jak sztuczna inteligencja korzysta z API?
Jeszcze kilka lat temu rozmowy o API najczęściej dotyczyły integracji systemów. Dopiero rozmowy o sztucznej inteligencji sprawiły, że zaczęłam zwracać na API uwagę w zupełnie innym kontekście.
Dziś coraz częściej pojawiają się obok tematów związanych ze sztuczną inteligencją. Powód jest prosty. Model AI potrafi analizować informacje i generować odpowiedzi. Sam jednak nie zna aktualnego stanu magazynu, nie widzi statusu zamówienia i nie wie, jaka jest pogoda w tej chwili.
Jeżeli aplikacja wykorzystująca model AI ma korzystać z aktualnych danych, musi otrzymać je z odpowiedniego źródła. Jednym ze sposobów połączenia jej z zewnętrznym systemem jest API.
W świecie sztucznej inteligencji pojawia się również pojęcie wywołania narzędzia, czyli tool callingu. Model AI może rozpoznać, że do odpowiedzi potrzebne są dane lub działanie zewnętrznego systemu, i przygotować ustrukturyzowaną prośbę o użycie odpowiedniego narzędzia.
Samo wywołanie wykonuje aplikacja współpracująca z modelem. Następnie przekazuje modelowi rezultat, na podstawie którego może powstać odpowiedź dla użytkownika.
Jeżeli aplikacja udostępnia mu odpowiednie narzędzia i uprawnienia, chatbot może nie tylko prowadzić rozmowę, lecz także pobierać informacje, sprawdzać statusy lub inicjować określone działania.
Im więcej rozwiązań opartych na sztucznej inteligencji trafia do codziennej pracy, tym większego znaczenia nabiera sprawna wymiana danych między systemami.
Coraz częściej wartością nie jest już samo przechowywanie informacji. Równie ważna staje się możliwość ich bezpiecznego udostępniania tam, gdzie są potrzebne.
Co to jest API? Podsumowanie
Pamiętam jedno z pierwszych służbowych spotkań w IT, podczas którego po raz kolejny padło słowo „API”. Złapałam się na tym, że nie tylko rozumiem sam skrót, ale też potrafię wyobrazić sobie drogę informacji pomiędzy systemami. To był jeden z tych momentów, kiedy techniczne pojęcie przestało być definicją, a zaczęło mieć praktyczny sens.
API nie jest celem samym w sobie. Jest ustaloną drogą, przez którą systemy wymieniają informacje i zlecają sobie określone działania.
Z perspektywy organizacji staje się jednym z elementów pozwalających połączyć dane, aplikacje i procesy biznesowe.
Im dłużej pracuję z systemami, tym rzadziej zaczynam od nazw technologii. Znacznie częściej zastanawiam się, jaką drogę musi przejść informacja. To właśnie ta perspektywa pomaga zrozumieć, co to jest API, a także integracje, dane, procesy biznesowe i coraz częściej rozwiązania oparte na sztucznej inteligencji.
Technologia staje się prostsza, kiedy nie zaczynamy od skrótów i narzędzi, lecz od pytania: Jaką drogę ma przejść informacja, żeby dotrzeć tam, gdzie jest potrzebna?
Gdy systemy komunikują się przez Internet, komputer musi jeszcze wiedzieć, dokąd wysłać żądanie. Skąd właściwie wie, gdzie znajduje się strona internetowa, którą chcemy otworzyć?
→ Jak komputer odnajduje stronę internetową?
FAQ
Co to jest API prostymi słowami?
API to ustalony sposób komunikacji między systemami lub częściami programu. Dzięki niemu jedna aplikacja może poprosić drugą o dane albo wykonanie określonego działania i otrzymać odpowiedź w ustalonej formie.
Czy trzeba znać programowanie, żeby rozumieć, co to jest API?
Nie. Podstawową zasadę komunikacji przez API można zrozumieć bez znajomości programowania.
Czym różni się API od procesu biznesowego?
API określa sposób wymiany danych i zlecania operacji między systemami. Proces biznesowy określa cel tych działań oraz to, co powinno wydarzyć się dalej.
Dlaczego firmy korzystają z API?
API pozwala łączyć różne systemy i ograniczać potrzebę ręcznego przepisywania danych. Może usprawniać wymianę informacji, ale bezpieczeństwo zależy od sposobu zaprojektowania i zabezpieczenia połączenia.
Jaką rolę API odgrywa w sztucznej inteligencji?
API daje aplikacji korzystającej z AI dostęp do aktualnych danych i zewnętrznych operacji – w granicach udostępnionych narzędzi i uprawnień.
Warto zajrzeć również do:
Źródło grafiki: Designed by Magnific.
