API (Application Programming Interface) to zestaw reguł, dzięki którym jeden program rozmawia z drugim. Możesz programować od lat albo nie napisać w życiu linijki kodu i tak korzystasz z API kilkanaście razy dziennie: przy logowaniu przez Google, płatności kartą, mapie w aplikacji dostawcy czy przelewie w banku. To rodzaj kontraktu między systemami: pytasz w ustalony sposób, dostajesz odpowiedź w ustalonym formacie.
Jak działa API: konkretny przykład
Zamawiasz pizzę przez aplikację i klikasz „zapłać BLIKIEM„. Co dzieje się w tle?
- Aplikacja wysyła request do API banku: „chcę zapłacić 45 zł z konta X do sklepu Y”.
- API banku sprawdza autoryzację, saldo i limity.
- Zwraca response: „transakcja zatwierdzona, ID abc123″.
- Aplikacja wysyła request do API restauracji: „zamówienie opłacone, można zaczynać”.
Całość dzieje się w ułamku sekundy, a Ty widzisz tylko komunikat „zamówienie przyjęte”. Każdy z tych kroków to osobne wywołanie API.
REST API: najczęstszy typ
Większość współczesnych API to REST API (Representational State Transfer). Działa przez HTTP, czyli ten sam protokół co strony internetowe, i opiera się na czterech podstawowych operacjach:
| Metoda HTTP | Co robi | Przykład |
|---|---|---|
GET |
pobiera dane | GET /users/123 → dane użytkownika 123 |
POST |
tworzy nowy zasób | POST /orders → nowe zamówienie |
PUT / PATCH |
aktualizuje istniejący zasób | PATCH /orders/456 → zmień status |
DELETE |
usuwa zasób | DELETE /users/123 → usuń konto |
Dane wędrują w formacie JSON, czyli lekkim formacie tekstowym, który rozumie każdy język programowania. Tak wygląda przykładowa odpowiedź API pogodowego:
{
„miasto”: „Warszawa”,
„temperatura”: 18,
„jednostka”: „Celsius”,
„opis”: „zachmurzenie umiarkowane”,
„wilgotnosc_procent”: 65
}
Klucz API: co to i po co
Większość API wymaga uwierzytelnienia, najczęściej przez klucz API, czyli długi, unikalny ciąg znaków generowany przez dostawcę usługi. Chcesz użyć API OpenAI we własnej aplikacji? Rejestrujesz się, generujesz klucz i dołączasz go w nagłówku każdego zapytania. Klucz mówi dostawcy, kto pyta, dzięki czemu może:
- liczyć zużycie i naliczać opłaty,
- ograniczać liczbę zapytań (rate limiting),
- odciąć dostęp, gdy ktoś łamie regulamin.
I tu najważniejsze ostrzeżenie: klucz API to hasło, więc nigdy nie wrzucaj go do publicznego repozytorium na GitHubie. Boty skanują go całą dobę w poszukiwaniu kluczy, a jeśli znajdą Twój, możesz dostać fakturę na tysiące dolarów, zanim się zorientujesz. Klucze trzymaj w zmiennych środowiskowych (plik .env), nie w kodzie.
API publiczne i prywatne
| Typ | Opis | Przykłady |
|---|---|---|
| Publiczne | dostępne dla każdego dewelopera, z otwartą dokumentacją | OpenWeather, NASA, NBP API |
| Partnerskie | dostępne po rejestracji i akceptacji | API bankowe, Google Maps, Allegro |
| Prywatne | tylko wewnątrz organizacji, na linii frontend i backend | wewnętrzne API e-commerce, komunikacja między mikroserwisami |
REST, GraphQL czy SOAP
REST to standard de facto: prosty, działa przez HTTP, stosuje go zdecydowana większość nowych API. GraphQL to pomysł Meta z 2015 roku, w którym klient sam określa, jakich pól potrzebuje, zamiast dostawać cały obiekt, co jest szybsze i wygodniejsze zwłaszcza w aplikacjach mobilnych (używają go między innymi GitHub i Shopify). SOAP to starszy, ciężki standard oparty na XML, ale bardzo sformalizowany, przez co wciąż trzyma się mocno w bankowości, ubezpieczeniach i dużych systemach korporacyjnych.
Chcesz przetestować API bez pisania kodu? Pobierz darmowy Postman, wpisz adres API i metodę (GET albo POST), w razie potrzeby dodaj klucz w nagłówku i od razu zobaczysz odpowiedź w formacie JSON. To najprostsza droga do nauki i debugowania.
Najczęstsze pytania o API
Co to jest API w prostych słowach?
API to okienko, przez które jedna aplikacja rozmawia z drugą, trochę jak kelner w restauracji: bierze zamówienie od klienta (frontendu), przekazuje je do kuchni (backendu) i przynosi odpowiedź. Klient nie wchodzi do kuchni, dogaduje się przez kelnera.
Konkretnie: gdy sprawdzasz kurs euro w aplikacji banku, ona pyta API NBP albo banku, a to zwraca aktualny kurs. Ty widzisz liczbę, cała rozmowa odbywa się w tle.
Czym różni się API od strony internetowej?
Strona internetowa zwraca HTML, który przeglądarka renderuje jako stronę do czytania przez człowieka. API zwraca dane (zwykle JSON lub XML) przeznaczone do odczytu przez inny program. Strona jest dla ludzi, API dla aplikacji.
Ile kosztuje używanie API?
To zależy od dostawcy. Wiele API ma darmowy próg (na przykład OpenWeather z tysiącem zapytań dziennie). API OpenAI rozlicza się za miliony tokenów, Google Maps daje darmowy limit ładowań map miesięcznie, a ceny API banków, płatności czy Allegro znajdziesz na stronach dostawców.
Co to jest endpoint API?
Endpoint to konkretny adres URL reprezentujący dany zasób lub operację. Na przykład api.nbp.pl/api/exchangerates/rates/a/eur/ to endpoint zwracający kurs euro. Każde API ma wiele endpointów, osobny dla użytkowników, osobny dla zamówień, osobny dla produktów.
Co to jest REST API?
REST (Representational State Transfer) to styl projektowania API oparty na HTTP. Używa standardowych metod (GET pobiera, POST tworzy, PUT lub PATCH aktualizuje, DELETE usuwa) i zwraca dane w JSON. To dziś najszerzej stosowany standard w aplikacjach webowych i mobilnych. Alternatywy to elastyczniejszy GraphQL i starszy, oparty na XML SOAP.
Jak API ma się do SEO?
W SEO API wykorzystuje się na kilka sposobów: do pobierania danych z Google Search Console, do szybkiego indeksowania treści przez Google Indexing API, do automatyzacji raportów z narzędzi takich jak Ahrefs czy Semrush oraz do generowania meta opisów na skalę przez API modeli AI. Znajomość API mocno przydaje się w technical SEO i automatyzacji.
