API integrace 2026: REST, GraphQL, MCP servery

API není jen pro vývojáře. V 2026 stojí celý byznys e-shopů, eventů a portálů na tom, jak mluví různé systémy spolu. Pokud jste zadavatel webu, který chce „kalendář akcí synchronizovaný s ColosseumTicket", „produkty z Heuréky", „mailing přes Mailgun" nebo „AI agent, který komunikuje se zákazníkem", potřebujete vědět, co API je, kdy ho potřebujete a kdy ne. Bez teorie a buzzwords.

Co se v tomto článku dozvíte

Co je API a jak funguje (přístup pro netechnické čtenáře)
4 typy API, se kterými se v marketingu setkáte (REST, GraphQL, Webhook, MCP)
Kdy API potřebujete a kdy si vystačíte bez něj
Reálné příklady z mého portfolia (PražskéMuzikály.cz, RealFree.cz, Mycí centra)
Co je nového v 2026: MCP servery, Function calling, AI agents

Co je API jednoduše

API = Application Programming Interface. Představte si to jako „okénko" mezi dvěma systémy, kterým si vyměňují data ve smluveném formátu. Aplikace A (váš web) řekne aplikaci B (ColosseumTicket): „Pošli mi seznam volných míst na představení X". B odpoví seznamem v JSON. To je API.

Místo lidsky napsaného mailu („Milí kolegové z ColosseumTicketu, máte volná místa na...") existuje strojový kontrakt, který oba systémy znají.

4 typy API, které potkáte v marketingu

1. REST API (zdaleka nejčastější)

HTTP request na URL, odpověď v JSON. Příklad:

GET https://api.example.cz/v1/products?category=cleaning
Authorization: Bearer YOUR_API_KEY

→ {"products": [{"id": 1, "name": "...", "price": 1499}]}

REST je standard pro 90 % integrací. Funguje i v 2026, je dobře dokumentovaný a podporuje ho každá služba.

2. GraphQL

Modernější alternativa k REST. Místo více endpointů (/products, /products/123/reviews) máte jeden a sami říkáte, co chcete:

query {
  product(id: 123) {
    name
    price
    reviews(limit: 5) { rating, text }
  }
}

Používá: Shopify, GitHub, Stripe (nedávno), HubSpot.

3. Webhooky (push API)

Opačný směr. Místo aby váš web ptal o data, jiný systém vám pošle zprávu, když se něco stane. Typické scenáře:

Stripe: „Zákazník zaplatil. Tady detail."
Mailgun: „E-mail se vrátil. Bounce."
GitHub: „Někdo pushl commit."
OneSignal: „Push notifikaci přijato 1342 uživateli."

Webhook je kritický pro real-time reakce — třeba potvrzení objednávky, antifraud, automatický refund.

4. MCP (Model Context Protocol) — novinka 2024+

Standard od Anthropicu (Claude tvůrci), který v 2025 přijal i OpenAI a Google. Univerzální způsob, jak AI agent komunikuje se světem — s vaším databází, kalendářem, e-mailem, CRM.

V praxi: napíšete MCP server (50–200 řádků kódu), ten vystavuje funkce typu „getCustomer(id)", „createInvoice(data)". Claude / ChatGPT / Cursor / agentic IDE pak může vaše funkce volat samostatně.

Příklad use casu: AI asistent na webu, který umí zákazníkovi rezervovat termín u kadeřnice (volá MCP server, který modifikuje DB).

Kdy API potřebujete (5 reálných scénářů)

Synchronizace dat z third-party (kalendář akcí, produktové feedy, recenze, ceny od konkurence). PražskéMuzikály.cz volají ColosseumTicket API a získávají dostupnost vstupenek v reálném čase.
Platby (Stripe, ComGate, GoPay, PayU). Bez API platební brány nemáte šanci.
E-mailing transakční (Mailgun, SendGrid, Postmark). Kdykoli zákazník provede akci → AI vygenerujete e-mail → odesílám přes API.
Push notifikace (OneSignal, Firebase). Pavel to využívá na PražskéMuzikály a RealFree pro Hlídacího psa.
Mobilní aplikace nebo headless frontend. Backend vystaví REST/GraphQL API a frontend (React Native, mobile app, iOS/Android) ho volá.

Kdy API NEPOTŘEBUJETE

Statický prezentační web bez interaktivity → vystačíte s formulářem a databází, žádné API.
Blog s ručně psanými články → neexportujete obsah jinam, žádný API kontext.
Malý e-shop pod 200 produktů → admin vlastní CMS bohatě stačí, integrace s Heurékou přes XML feed (ne API).

Co je nového v 2026

Function calling v AI

OpenAI / Anthropic / Google dovolují AI volat vaše API funkce jako součást konverzace. Příklad: zákazník na webu chatuje s AI: „chci rezervovat střih na pátek". AI volá vaši funkci checkAvailability("pátek"), dostane data, navrhne termín, zákazník potvrdí, AI volá createReservation(...).

MCP servers — exponenciální růst

V dubnu 2026 existuje > 5 000 veřejných MCP serverů na npm, GitHub a Anthropic registry. Marketéři to používají pro automatické reportování (MCP server pro GA4, Search Console, Mailchimp) bez nutnosti psát skripty.

Server-side tracking přes API

S příchodem cookieless trackingu (Safari ITP, Firefox ETP, Chrome 3rd party cookie deprecation) se měření přesouvá na server. GTM Server-Side, Stape, RudderStack — všechno přes API.

Reálné případové studie

PražskéMuzikály.cz × ColosseumTicket

Web volá API ColosseumTicket každých 30 minut a stahuje:

Volná místa pro 1 200+ představení
Aktuální ceny (často s dynamic pricing)
Detaily akce (popis, fotka, zákulisní info)

Bez API by se to muselo aktualizovat ručně — nereálné.

Zveráč.cz × 8 affiliate e-shopů

53 000 produktů z 8 e-shopů. Affiliate import feed pipeline:

1× denně cron stáhne XML/CSV feed z každého e-shopu
Párování podle EAN — najde stejný produkt napříč e-shopy
Aktualizuje cenu, dostupnost, obrázek, recenze
Webhook od e-shopu při velkých změnách (sezóna, výprodej)

Mycí centra × Klient PDF nabídka

Obchodník v adminu sestaví nabídku z katalogu produktů, upraví ceny a podmínky. Aplikace zavolá interní PDF generátor (vlastní mikroservice) s daty a vrátí URL na PDF. Klient dostane e-mail.

Časté chyby v API integracích

API klíče v kódu / v gitu. Klasická bezpečnostní díra. Vždy .env + .gitignore.
Žádný rate limiting na vaší straně. Třetí strana pošle 100 webhooků za sekundu, váš server padá.
Synchronní volání cizího API z hlavní stránky. Když ColosseumTicket je 5 sekund pomalý, vaše stránka taky. Lepší: cache + pravidelný cron.
Žádný retry / fallback. API spadne, vaše integrace umírá. Vždy retry s exponential backoff a fallback (např. cached verze).
Žádný monitoring. Nevíte, že vám API integrace 3 dny nefunguje, protože změnili autentizaci. Doporučuju Better Stack, Sentry nebo Healthchecks.io.

Jak zadat API integraci dodavateli

Cíl integrace — co konkrétně chcete (např. „synchronizovat produkty z Heuréky 1× denně").
Frekvence — real-time, 1× za hodinu, 1× za den?
Co se má stát při chybě — alert na e-mail? Retry? Fallback?
Limit volání — kolik dotazů API třetí strany tolerujete denně (často placené over $0,001/call).
Dokumentace API třetí strany — link, ne „pošlete mi pak".
Test prostředí — ano/ne. Stripe a Mailgun mají test mode, Heuréka ne.

Časté otázky

Kolik stojí API integrace?

Záleží na složitosti. Jednoduchá REST integrace (volání 5 endpointů, mapování dat) = 8–20 tis. Kč. Komplexní (Stripe checkout flow, webhook handlers, refund logic) = 30–80 tis. Kč. Custom MCP server pro AI agenta = 25–60 tis. Kč.

Co když API třetí strany změní formát?

Stane se. Renomované služby (Stripe, Mailgun) drží zpětnou kompatibilitu min. 2 roky a versionují endpointy. Menší služby (lokální feed) můžou změnit formát ze dne na den. Vždy mějte monitoring a alert.

Mohu integrace dělat sám bez API?

Ano, přes RPA nástroje (Zapier, Make, n8n). Pro malé objemy (do 500 operací měsíčně) výborné. Nad to už vychází vlastní integrace levněji a spolehlivěji.

Co je rozdíl mezi REST a GraphQL?

REST = více endpointů, vrací předem definované struktury. GraphQL = jeden endpoint, klient si říká, co chce. GraphQL je flexibilnější, REST jednodušší. Obě jsou validní volby.

Co je MCP a proč o tom všichni mluví?

Model Context Protocol je standard, jak AI mluví s aplikacemi. Řekněme, že chcete, aby Claude / ChatGPT mohl opravdu rezervovat termín u vašeho kadeřníka, ne jen poradit. MCP server je most mezi AI a vaším systémem.

API integrace 2026: REST, GraphQL, Webhooky a MCP servery — průvodce pro netechnické čtenáře