Jak działa API? Jak zintegrować API z aplikacją

Interfejs programowania aplikacji (API) jest jednym z ostatnich elementów niezbędnych do tworzenia inteligentnych aplikacji. Jest to kanał komunikacji pomiędzy dwiema aplikacjami. Świadomie lub nie, korzystałeś kiedyś z interfejsów API podczas przeglądania Internetu lub korzystania z programów w życiu codziennym.

Interfejsy API często wysyłają w odpowiedzi złożone dane. Jak więc zrozumieć i wykorzystać te informacje, aby służyć użytkownikom? Interfejsy API ułatwiają życie zarówno doświadczonym programistom, jak i tym, którzy dopiero zaczynają. Musisz więc wiedzieć, jak z nich korzystać w swojej aplikacji.

Mając kilka przypadków użycia i przykładów, przyjrzyjmy się, jak możesz używać interfejsów API do obsługi programów jako programista.

Co to jest API?

Interfejsy API umożliwiają wzajemną interakcję oddzielnych programów

Interfejsy API umożliwiają wzajemną interakcję oddzielnych programów. Interfejsy API definiują żądania, które można wysyłać, sposób ich realizacji i umożliwiają wymianę danych pomiędzy różnymi aplikacjami.

Interfejsy API są dostępne w 3 typach: publiczne, prywatne i partnerskie. Publiczne interfejsy API (lub otwarte interfejsy API) są publicznie dostępne dla każdego programisty. Korzystanie z publicznych interfejsów API wiąże się z pewnymi ograniczeniami i może być bezpłatne lub komercyjne. Prywatne interfejsy API są używane wyłącznie w firmie lub organizacji. Interfejsy API partnerów są dostępne tylko dla określonych partnerów biznesowych i najczęściej są używane w celu ułatwienia integracji oprogramowania między dwiema różnymi firmami.

Jak działa API?

Programiści tworzą interfejsy API jako produkty, które mogą służyć innym programistom. Celem jest ułatwienie, usprawnienie i przyspieszenie złożonych procesów tworzenia stron internetowych dla programistów konsumenckich lub firm.

Większość firm polega obecnie na interfejsach API innych firm, aby rozwiązywać problemy i lepiej służyć swoim klientom. Jednak korzystanie z API nie jest tak skomplikowane, jak wielu osobom się wydaje. Można o tym myśleć jak o rozwiązaniu innej firmy, które daje konkretną odpowiedź w postaci danych, gdy wysyłasz określone żądanie HTTP.

Korzystanie z API przypomina składanie zamówienia w pizzerii. Nie możesz iść do kuchni i powiedzieć im, czego chcesz. Potrzebujesz kelnera, który przyjmie Twoje zamówienie i dostarczy je do kuchni, a następnie wróci z wybraną pizzą.

Możesz myśleć o interfejsie API jako o łączniku między Tobą a kuchnią. W tym przypadku jesteś klientem odwiedzającym restaurację obsługującą kelnerów (API). Następnie kelner odpowie, podając wybraną przez Ciebie pizzę (dane). W prawdziwym interfejsie API aplikacja internetowa jest klientem, który żąda wykorzystania treści dostawcy za pośrednictwem interfejsu API, wysyłając żądania HTTP do punktu końcowego.

W jaki sposób wykorzystywane jest API?

W wielu przypadkach używane są interfejsy API

Interfejsy API są używane w wielu scenariuszach, w tym w kategoriach takich jak interfejsy API baz danych, zdalne interfejsy API i interfejsy API sieci Web. Najprawdopodobniej korzystasz z internetowych interfejsów API wiele razy dziennie podczas przeglądania na smartfonie lub komputerze. Interfejsy API sieci Web wymieniają żądania i dane przy użyciu protokołu HTTP.

Witryny rezerwacji podróży, takie jak Skyscanner i Booking.com, korzystają z internetowych interfejsów API w celu agregowania danych o lotach i miejscach docelowych dla klientów. Wygoda internetowych interfejsów API umożliwia potwierdzenie dostępności pokoi hotelowych i czasu pobytu w czasie rzeczywistym poprzez natychmiastową wymianę zapytań i danych z hotelu.

Co to jest punkt końcowy interfejsu API?

Połączenie z interfejsem API wymaga podłączenia programu do punktu końcowego interfejsu API. Można to traktować jako połączenie dwukierunkowe. Punkt końcowy podłączony do Twojego programu wysyła żądanie, natomiast punkt końcowy podłączony do API odsyła Ci konkretną odpowiedź.

Punkt końcowy to adres URL żądania , który zapewnia klientowi bezpośredni dostęp do zasobów interfejsu API.

Oprócz pobierania danych za pomocą API, możesz także wykonać żądania POST od dostawcy do klienta, użyć metody PUT, aby uzyskać więcej informacji od dostawcy, a także użyć metody DELETE, aby usunąć istniejące dane ze swojego programu. Każda z tych metod jest zwykle dostępna w dokumentacji API.

Kryteria łączenia się z API

Integracja interfejsu API z programem nie jest decyzją spontaniczną — jest przemyślana. Musisz znać żądane informacje i ilość. Pomaga to zmniejszyć złożoność, zwłaszcza jeśli przetwarzasz dane JSON jako tablicę wielowymiarową. Pozwala także uzyskać szczegółowe informacje potrzebne do realizacji programu.

Istnieją setki interfejsów API z różnymi zasadami łączenia się z nimi. Chociaż niektóre interfejsy API są bezpłatne i mają otwarte oprogramowanie, inne są dostępne wyłącznie na zasadzie subskrypcji.

Podczas gdy niektóre interfejsy API są płynne i proste i nie wymagają żadnych wymagań wstępnych, inne interfejsy API mogą wymagać spełnienia warunków, takich jak wygenerowanie klucza API lub zarejestrowanie konta programisty, zanim będzie można połączyć się z punktem końcowym.

Jednak jednym z najważniejszych aspektów każdego API jest jego dokumentacja. Najlepiej przeczytać i postępować zgodnie z dokumentacją dowolnego interfejsu API, z którym planujesz się połączyć, aby uzyskać instrukcje dotyczące kodowania i korzystania z jego zasobów. Dzieje się tak, ponieważ każdy interfejs API ma własne metody połączenia i instrukcje.

Aby połączyć się z dowolnym API, musisz także znać obsługiwane przez nie języki programowania.

Jak połączyć się z API: Przykład praktyczny

Nie ma konkretnego sposobu łączenia się z interfejsem API, ale niektóre przykłady pokażą podstawy korzystania z danych interfejsu API w aplikacji.

Przyjrzyjmy się krótkiemu przykładowemu kodowi, w jaki sposób można połączyć się z interfejsem API.

Jak korzystać z API Iro.Js Color Picker

Iro.js to proste API, które umożliwia dodanie darmowego selektora kolorów do Twojej witryny. Po wybraniu punktu na kole kolorów interfejs API zwraca kod szesnastkowy lub RGB tego koloru. Aby połączyć się z API iro.js wystarczy wkleić jego punkt końcowy CDN (Content Delivery Network) na początku DOM.

Pełna dokumentacja tego API jest dostępna na iro.js.org:

https://iro.js.org/guide.html

Zobaczmy, jak połączyć się z tym interfejsem API, korzystając z przykładowego kodu poniżej:

Display color picker

W przypadku powyższego przykładowego API, aby się z nim połączyć, nie jest potrzebny klucz API. Aby jednak lepiej zrozumieć, przyjrzyjmy się bliżej JavaScriptowi. Aby połączyć się z tym API, po prostu wywołaj funkcję ColorPicker z klasy iro , a następnie przekaż do klasy identyfikator kontenera koła kolorów.

Połączenie z punktem końcowym API iro.js jest łatwe, ponieważ jego programiści wykonali dodatkową pracę polegającą na zakodowaniu warstwy dla użytkowników. Poniższy obraz jest wynikiem powyższego przykładowego kodu.

Wynik przykładowego kodu

Aby zobaczyć, jak zachodzi zdarzenie zmiany koloru, możesz otworzyć inny plik HTML i wkleić następujący kod do jego sekcji skryptów :

var colorPicker = new iro.ColorPicker('#color-pick', {
   // Set the size of the color picker
   width: 400,
   // Set the initial color to pure red
   color:"#ff0000"
 });
const myColor =(color)=>{
	console.log(color.hexString);
};
colorPicker.on("color:change", myColor);

Powyższy kod rejestruje szesnastkowe wartości kolorów za każdym razem, gdy zmieniasz pozycję próbnika kolorów na kole.

Jak korzystać z API wymiany walut NoCodeAPI

NoCodeAPI udostępnia wiele interfejsów API, w tym interfejs API do przeliczania walut. Aby połączyć się z tym punktem końcowym wymiany walut, odwiedź NoCodeAPI i utwórz konto:

https://app.nocodeapi.com/login

Po zalogowaniu się na górze strony znajduje się pasek wyszukiwania. W pasku wyszukiwania wpisz wymiana walut , a gdy pojawi się Twoje zapytanie, kliknij Aktywuj.

Na następnej stronie kliknij opcję Utwórz interfejs API wymiany walut . Następnie wprowadź nazwę API i kliknij Utwórz.

Po utworzeniu interfejsu API kliknij opcję Wyświetl dokumentację. Następnie wybierz preferowany język, aby wyświetlić kod łączący się z punktem końcowym API. Następnie możesz skopiować ten przykładowy kod i wkleić go do swojej aplikacji w celu dalszego dostosowania.

Zobacz przykładowy kod poniżej do przeliczania walut: