Co to jest API? API - definicja
API (ang. Application Programming Interface) czyli interfejs programowania aplikacji, to zestaw komend, protokołów i narzędzi, który pozwala aplikacjom na sprawną komunikację między nimi. Służy do wymiany danych, zwracania odpowiednich zasobów.
Do czego służy API?
API jest najczęściej wykorzystywane przez zaawansowane aplikacje, w tym strony internetowe do komunikacji z innymi serwisami, lub nawet ze skryptami w JavaScript, które dostępne są od strony frontendu użytkownika przeglądającego witrynę. Najprostszym przykładem jest zbieranie statystyk dotyczących użytkowników na stronie, skrypt umieszczony w kodzie strony komunikuje się z serwerem, aby przesyłać informacje o zachowaniu użytkownika, bez potrzeby odświeżania strony.
Kluczowe elementy API
API składa się z kilku kluczowych elementów:
- Dokumentacja - Większość rozbudowanych systemów API posiada dokładną dokumentacje, z której może skorzystać każda zainteresowana osoba, pomaga ona w sprawnym korzystaniu z narzędzi, które udostępnia API.
- Parametry - Metody API przyjmują różne parametry, na przykład informację o tym, że użytkownik wybrał daną opcję filtrowania w tabelii, ale również mogą różne parametry zwracać.
- Autoryzacja - Interfejs API jest zabezpieczony poprzez różne systemy autoryzacji, na przykład może być wymagane przesłanie w nagłówku zapytania odpowiedniego kluczu.
- Formaty danych - API określa formaty, w których przyjmuje i zwraca dane, najpopularniejszymi formatami jest JSON i XML.
Przykład użycia API
Zbudowaliśmy swoją stronę internetową, która pokazuje pogodę dla danego regionu - ale nie mamy źródła tych informacji - więc korzystamy z API (płatnego, lub darmowego) do pobierania informacji o pogodzie, a następnie wyświetlania ich na naszej stronie - po stronie serwera, lub użytkownika korzystając z JavaScript.