REST API
Aktualizováno 22. 9. 2026
REST API je rozhraní, přes které si dva systémy vyměňují data pomocí běžných HTTP požadavků, typicky ve formátu JSON. V e-shopu přes něj komunikuje platforma s ERP, skladem, dopravci, marketplace nebo platební bránou.
Rychlá fakta
- Typ
- architektonický styl rozhraní nad protokolem HTTP (Roy Fielding, 2000)
- Cena
- zdarma — jde o standard; náklady jsou ve vývoji a provozu integrace, u některých platforem je přístup k API vázaný na vyšší tarif
- Formát dat
- nejčastěji JSON, autorizace přes API klíč, OAuth nebo token
- Časová náročnost integrace
- řádově dny (jednoduchý jednosměrný přenos) až týdny (obousměrná synchronizace objednávek a skladu s ERP)
- Náročnost integrace
- střední — samotné volání je jednoduché, práci dávají limity, chyby, stránkování a mapování dat
- Vhodné pro
- napojení ERP, skladu, dopravců, marketplace a dodavatelů tam, kde nestačí XML feed
Co to je
API (Application Programming Interface) je dohodnutý způsob, jak se jeden program ptá druhého na data nebo mu je posílá. REST je nejrozšířenější styl, jak taková rozhraní na webu stavět. Pojem zavedl Roy Fielding ve své disertační práci na University of California v Irvine v roce 2000.
Pro majitele e-shopu stačí vědět tohle: když váš e-shop „posílá objednávky do Pohody" nebo „stahuje sklad od dodavatele v reálném čase", velmi často za tím stojí právě REST API.
Jak to funguje
REST pracuje se zdroji (produkty, objednávky, zákazníci). Každý zdroj má svou adresu a pracuje se s ním pomocí HTTP metod:
| Metoda | Co dělá | Příklad v e-shopu |
|---|---|---|
| GET | čte data | stáhni objednávky od včerejška |
| POST | vytváří záznam | založ nový produkt |
| PUT / PATCH | mění záznam | nastav sklad produktu na 12 kusů |
| DELETE | maže záznam | smaž neplatný kupon |
Odpověď přichází nejčastěji v JSON a s HTTP stavovým kódem: 200 je v pořádku, 401 znamená chybnou autorizaci, 404 neexistující záznam, 429 příliš mnoho požadavků, 5xx chybu na straně serveru.
Dva principy REST, které mají v praxi dopad:
- Bezstavovost. Každý požadavek musí nést všechno, co server potřebuje (včetně autorizace). Server si mezi požadavky nic nepamatuje.
- Jednotné rozhraní. Stejné operace fungují stejně napříč zdroji, takže se API dá rychle naučit.
REST API u e-shopových platforem
- WooCommerce má vestavěné REST API (
/wp-json/wc/v3/), přístup přes consumer key a consumer secret vygenerované v administraci. - Magento (Adobe Commerce) nabízí REST i GraphQL.
- Shopify označil REST Admin API od 1. 10. 2024 za legacy. Od 1. 4. 2025 musí nové veřejné aplikace v Shopify App Store používat výhradně GraphQL Admin API.
- Shoptet na standardních tarifech přímé REST API nemá, privátní API dostává až Shoptet Premium, viz Shoptet.
- Marketplace jako Etsy (Open API v3) nebo Allegro mají vlastní REST API pro produkty a objednávky.
Výhody a limity
Výhody
- Data téměř v reálném čase, bez čekání na další stažení feedu.
- Obousměrnost: můžete číst i zapisovat (sklad tam, objednávky zpět).
- Široká podpora. REST umí prakticky každý programovací jazyk i nástroje jako n8n nebo Make.
Limity
- Rate limity. Každé API omezuje počet požadavků za čas. Integrace musí umět počkat a zkusit to znovu.
- Mnoho dotazů. Pro složitější data (objednávka + položky + zákazník + doprava) někdy potřebujete několik volání. Tohle řeší GraphQL.
- Změny verzí. Poskytovatel API mění a vypíná staré verze. Integrace potřebuje údržbu, viz Verzování API a zpětná kompatibilita.
- Bezpečnost. API klíč s právem zápisu je jako klíč od skladu. Patří do trezoru, ne do tabulky nebo e-mailu. Víc v článku Bezpečnost API integrací v ecommerce.
- Polling. Když se API jen ptáte „je něco nového?", plýtváte dotazy. Lepší je kombinace s webhooky.
Jak to řešíme v Převeďshopu
API integrace stavíme tak, aby přežily výpadek druhé strany a daly se udržovat. Konkrétně:
- Návrh toku dat — co je zdrojem pravdy pro produkty, sklad, ceny a objednávky, jak často se synchronizuje a co se stane při chybě.
- Implementace — napojení e-shopu na ERP, sklad, dopravce, marketplace nebo dodavatele. Kde je to vhodné, přes middleware, aby jedna změna nerozbila všechno. Detail na stránce Integrace.
- Vlastní API a microservices, když potřebujete rozhraní pro partnery nebo mobilní aplikaci, viz API a microservices.
- Monitoring a opakování — logy, upozornění na chyby a automatické opakování neúspěšných požadavků.
Základní synchronizace objednávek a skladu s ERP obvykle trvá 2–4 týdny. Cenu ostatních integrací připravíme po konzultaci podle rozsahu.