Czym jest API · Koduj z Martinem

Dowiedz się, jak strony rozmawiają ze sobą – i jak twoja może pytać o pogodę, mapy albo AI.

Kelner między dwiema kuchniami

Wyobraź sobie restaurację. Ty (twoja strona) chcesz zamówić jedzenie, ale nie wolno ci do kuchni (obca usługa – pogoda, mapy, AI). Do tego jest kelner – bierze zamówienie, niesie do kuchni i przynosi gotowe danie.

Takim kelnerem jest API (Application Programming Interface). To ustalony sposób, w jaki programy proszą się nawzajem o dane:

Twoja strona wysyła żądanie („Jaka będzie jutro pogoda w Brnie?”).
API przekazuje je usłudze, która zna odpowiedź.
Usługa zwraca odpowiedź w ustalonym formacie.

Pokażę ci: JSON – wspólny język

Programy odpowiadają sobie w formacie JSON. Wygląda prawie jak obiekt JavaScript, który znasz z poziomu Mag:

{
  "mesto": "Brno",
  "teplota": 21,
  "slunecno": true,
  "dny": ["Saturday", "Sunday"]
}

Tekst w cudzysłowach, liczby bez.
true/false znasz z warunków.
Kwadratowe nawiasy = lista, klamrowe = obiekt.

Spróbuj teraz – otwórz w przeglądarce ten adres (prawdziwe API pogody, darmowe, bez rejestracji):

https://api.open-meteo.com/v1/forecast?latitude=49.19&longitude=16.61&current_weather=true

Zobaczysz JSON z aktualną pogodą w Brnie. Bez grafiki – czyste dane. Grafikę zbudujesz ty!

💡

API jest wszędzie. Gdy aplikacja pokazuje prognozę, rozkład autobusów albo mapę, prawie nigdy nie ma tych danych sama – pyta przez API. Teraz uczysz się robić to samo.

Teraz ty 💪

Otwórz link pogody powyżej i przeczytaj JSON na głos – co oznaczają liczby i true/false?
Zmień współrzędne na swoje miasto (wyszukaj latitude/longitude) i zobacz inną pogodę.
W notatkach projektu zapisz: co twoja strona mogłaby dostać z API? (pogoda? mapa? cytat dnia?)

✅

Sprawdź się: Otworzyłeś prawdziwe API w przeglądarce i rozumiesz JSON. Wiesz, że API to kelner między twoją stroną a światem.

Co wyniesiesz z tej lekcji

API = ustalony sposób proszenia innych programów o dane.
JSON to format odpowiedzi – wygląda jak obiekty JavaScript.
Prawdziwe API możesz otworzyć w przeglądarce i zobaczyć surowe dane.