Co je to API · Programuj z Marcinym

Zjistíš, jak si weby povídají mezi sebou – a jak si tvůj web může říct o počasí, mapy nebo AI.

Číšník mezi dvěma kuchyněmi

Představ si restauraci. Ty (tvůj web) si chceš objednat jído, ale do kuchyně (cizí služba – počasí, mapy, AI) nesmíš. Od toho je tu číšník – vezme objednávku, odnese ji do kuchyně a přinese ti hotové jído.

Ten číšník se jmenuje API (Application Programming Interface). Je to domluvený způsob, jak si programy říkají o data:

Tvůj web pošle požadavek („Jaké bude zítra počasí v Brně?”).
API ho předá službě, která odpověď zná.
Služba vrátí odpověď v domluveném formátu.

Pokaż mi to: JSON – společný jazyk

Programy si odpovídají ve formátu JSON. Vypadá skoro jako JavaScript objekt, který už znáš z Czarodzieja:

{
  "mesto": "Brno",
  "teplota": 21,
  "slunecno": true,
  "dny": ["sobota", "neděle"]
}

Texty jsou v uvozovkách, čísla bez nich.
true/false znáš z podmínek.
Hranaté závorky = seznam, složené = objekt.

Vyzkoušej si to hned – otevři v prohlížeči tuhle adresu (je to skutečné API s počasím, zadarmo a bez registrace):

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

Uvidíš JSON s aktuálním počasím v Brně. Žádná grafika – jen čistá data. Grafiku kolem nich postavíš ty!

💡

API jsou všude. Když ti mobilní apka ukáže předpověď, jízdní řád nebo mapu, skoro nikdy ta data nemá sama – ptá se přes API. Ty se teď naučíš totéž.

Teraz ty 💪

Otevři adresu výše v prohlížeči a najdi v odpovědi aktuální teplotu a rychlost větru.
Zkus v adrese změnit latitude a longitude na souřadnice svého města (najdeš je na mapy.cz – pravé tlačítko → „Co je zde?”).
K projektu si napiš 2–3 nápady, jaká cizí data by se na tvém webu hodila:

🏫 Stránky školy – nápady

Počasí na školní výlet, mapa s polohou školy, jídelníček z API jídelny (pokud ho má), svátky a prázdniny.

🙋 Osobní stránky – nápady

Počasí v tvém městě, mapa míst, kde jsi byl(a), AI chatbot, který o tobě odpoví návštěvníkům.

🌍 Dziennik podróży – nápady

Mapa se špendlíky výletů, počasí v cíli příští cesty, převod měn pro cestovní rozpočet.

⚽ Web klubu – nápady

Počasí na zápas o víkendu, mapa hřiště pro hosty, AI pomocník s pravidly fotbalu.

✅

Kontrola: Umíš vysvětlit, co je API (číšník mezi programy) a poznáš JSON. Viděl(a) jsi skutečnou API odpověď v prohlížeči.

Co si z téhle lekce odnést

API = domluvený způsob, jak si programy říkají o data.
Odpovědi chodí v JSON – objekty a seznamy jako v JavaScriptu.
V další lekci si data z API stáhneš přímo do svého webu pomocí fetch.