API, požadavky a JSON

Tři pojmy, které spolu souvisí a dohromady popisují, jak si programy předávají informace.

API

API je domluvený způsob, jak se jeden program zeptá druhého.

Existují dva druhy API, se kterými přijdeš do styku:

1. Cizí API

   Někdo jiný nabízí službu a ty se jí ptáš. Předpověď počasí, kurzy měn, odeslání e-mailu, platby, mapy. Obvykle potřebuješ klíč.

2. Tvoje vlastní API

   Tvůj frontend se ptá tvého serveru. „Dej mi seznam mých úkolů.“ „Ulož tenhle záznam.“ Tohle vzniká automaticky, když stavíš aplikaci.

Požadavek a odpověď

Komunikace přes API má vždycky dvě části: požadavek (request) a odpověď (response).

Požadavek obsahuje:

• adresu – kam se ptám;
• metodu – co s tím chci dělat;
• hlavičky – doprovodné informace, často včetně přihlášení;
• tělo – data, která posílám (u některých metod).

Metody, které uvidíš:

Odpověď obsahuje hlavně stavový kód a data.

JSON

JSON je formát, ve kterém si programy předávají data. Je to text, který zvládne přečíst i člověk.

{
  "jmeno": "Martin",
  "email": "martin@example.cz",
  "aktivni": true,
  "projekty": ["web", "aplikace"],
  "pocetProjektu": 2
}

Pravidla, která stačí znát:

• Složené závorky {} obalují objekt – skupinu údajů, které patří k sobě.
• Hranaté závorky [] obalují seznam.
• Text musí být v uvozovkách, čísla ne.
• Mezi položkami je čárka, za poslední položkou ne.

Kdy o tom Claude bude mluvit

• „Uděláme API endpoint na /api/ukoly.“ → Vytváří adresu, na kterou se bude frontend ptát.
• „Vrací to 401, takže problém je v autentizaci.“ → Není přihlášený nebo chybí token.
• „Odpověď je JSON, tak si z něj vytáhneme pole items.“ → Data přišla v JSONu a bere si z nich jednu část.

Co se může pokazit

1. Klíč v prohlížeči

   Když se frontend ptá cizího API přímo, klíč musí být v prohlížeči – a tím je veřejný. Řešení: ptá se tvůj server, klíč zůstane u něj. Modul 13.

2. Limit dotazů

   Cizí API mívají limit. Když ho překročíš, dostaneš 429. Řešení bývá výsledky si ukládat a neptat se pořád dokola.

3. Cizí služba nefunguje

   Stane se. Aplikace na to musí být připravená a ukázat srozumitelnou hlášku, ne prázdnou obrazovku.

4. Změna formátu odpovědi

   Cizí API se občas změní. Co včera fungovalo, dnes vrací něco jiného. Proto se u důležitých integrací hodí kontrola, že odpověď vypadá, jak má.