Co je API (Application Programming Interface)?
API (zkratka z anglického Application Programming Interface) je sada pravidel, díky které si jeden program řekne jinému o data nebo o nějakou akci. Určuje, o co můžete požádat, jak o to požádat a co dostanete zpátky. Když vám aplikace ukáže předpověď počasí na zítřek, sama žádné počasí neuchovává. Zavolá přes API službu s počasím a zobrazí vám odpověď.
API používáte celý den, aniž byste o tom věděli. Přihlášení přes Google, platba kartou na internetu, mapa vložená do stránky: pokaždé API potichu předává požadavek z jednoho systému do druhého.
Lidsky řečeno
Představte si API jako číšníka v restauraci. Nejdete si do kuchyně uvařit sami. Přečtete si jídelní lístek (seznam toho, co si můžete objednat), řeknete číšníkovi, co chcete, a on vám to přinese. Kuchyně zůstává schovaná, vy se bavíte jen s lístkem a s číšníkem. API je přesně ten lístek a ten číšník: jasný seznam toho, o co můžete požádat, a posel, který odnese požadavek a přinese odpověď.
Jak API funguje
Většina API funguje na jednoduchém principu: ven jde požadavek, zpátky přijde odpověď.
- Požadavek říká, co chcete. Jde na konkrétní adresu, které se říká endpoint, třeba
api.pocasi.cz/predpoved. Můžete k němu přidat podrobnosti, například město a datum. - Služba požadavek přijme, udělá práci (najde data, uloží záznam, spočítá výsledek) a pošle odpověď.
- Odpověď nese výsledek, obvykle jako strukturovaná data ve formátu JSON, který přečte člověk i program.
Pár pojmů, na které budete narážet:
- Endpoint je konkrétní adresa, kterou voláte pro jeden typ akce.
- Požadavek a odpověď jsou otázka a odpověď.
- API klíč je heslo, které dokazuje, kdo volá, aby vás služba poznala a hlídala, kolik toho využíváte.
Hlavní myšlenka je, že nikdy nemusíte vědět, jak druhý systém funguje uvnitř. Stačí vědět, o co požádat a co dostanete zpátky.
Proč na API záleží
Díky API vzniká dnešní software rychle, místo aby se pokaždé psal od nuly.
- Znovu využijete, místo abyste stavěli znovu. Potřebujete platby? Zavoláte Stripe. Potřebujete mapy? Zavoláte Google Maps. Ušetříte měsíce práce tím, že požádáte hotovou službu.
- Systémy se propojí. Váš e-shop si přes API povídá se skladem, fakturací i dopravcem, takže objednávka projde, aniž by ji někdo znovu přepisoval.
- AI nástroje na nich stojí. Když chatbot odpovídá z vašich dokumentů nebo agent domluví schůzku, na pozadí volá API. Nástroje jako ChatGPT nebo Claude jsou samy dostupné přes API, a právě tak firmy zabudují AI do vlastních produktů.
Pro byznys to znamená rychlejší dodání a méně integrací šitých na míru. Čím lépe je API zdokumentované a navržené, tím rychleji na něm postaví ostatní týmy.
Na co si dát pozor
- Bez připojení nejsou aktuální data. API vrátí jen to, co služba za ním skutečně má. Když jsou data zastaralá nebo služba spadne, dostanete zastaralé odpovědi, nebo nic.
- Limity na počet požadavků. Většina API omezuje, kolik požadavků smíte poslat za určitý čas. Když limit překročíte, volání začnou selhávat, často v nejméně vhodnou chvíli.
- Změny, které rozbijí kód. Když poskytovatel API změní, kód postavený na staré verzi může přestat fungovat. Proto pořádná API používají verze a jasnou dokumentaci.
- Únik API klíče. Klíč je heslo. Když skončí ve veřejném kódu, někdo vám může navýšit účet nebo se dostat k vašim datům. Klíče držte v tajnosti a při pochybnostech je vyměňte.
Související články
- Co je to SDK a jak pomůže vašemu byznysu? - Sada nástrojů, se kterou vývojáři staví nad vaším produktem.
- Pochopení rozdílu: SDK vs. API při vývoji softwaru - Příbuzné pojmy s jinou rolí, vysvětlené vedle sebe.
- Zlepšete adopci API s OpenAPI specifikací - Nejrozšířenější standard pro dokumentaci a používání REST API.
Chcete být o krok napřed?
Nenechte si utéct naše nejlepší postřehy. Žádný spam, jen praktické analýzy, pozvánky na exkluzivní eventy a shrnutí podcastů přímo do vaší schránky.