# Shoptet API: co umí, limity a jak začít > Průvodce Shoptet API v češtině: rozdíl mezi privátním API pro Premium a veřejným API pro doplňky, co všechno pokrývá, webhooky, limity spojení a jak začít. - **Zdroj:** https://www.webotvurci.cz/navody/shoptet-premium/shoptet-api-pruvodce/ - **Doplněk / kategorie:** Shoptet Premium (https://www.webotvurci.cz/navody/shoptet-premium/) - **Datum:** 2026-10-02 - **Autor:** Webotvůrci (https://www.webotvurci.cz/) --- **Shoptet API je rozhraní, přes které jiný program čte a zapisuje data e-shopu na Shoptetu — produkty, objednávky, zákazníky, sklad nebo doklady — bez klikání v administraci.** Komunikuje se s ním přes REST a odpovědi chodí ve formátu JSON. Oficiální dokumentace je na [api.docs.shoptet.com](https://api.docs.shoptet.com/shoptet-api/openapi), je v angličtině a je psaná pro vývojáře. Tenhle průvodce shrnuje to podstatné česky: jaké API existují, co pokrývají, kde mají limity a jak se do napojení pustit. Pokud potřebujete jen vytvořit klíč a poslat ho partnerovi, jděte rovnou na návod [Jak vytvořit Shoptet Premium API klíč](https://www.webotvurci.cz/navody/shoptet-premium/jak-vytvorit-shoptet-premium-api-klic/). Tady je přehled toho, co s klíčem jde dělat. ## Dvě cesty k API: privátní a pro doplňky Shoptet má jedno API, ale dva způsoby, jak se k němu dostat. Liší se tím, kdo k datům přistupuje a jak se přihlašuje. **Privátní API** je přímý přístup majitele e-shopu k vlastním datům. Je dostupné **jen pro Shoptet Premium**. Token vytvoříte v administraci (Propojení → Private API) a předáte ho tomu, kdo napojení staví. Na jeden e-shop jde vytvořit **nejvýš 10 privátních tokenů**. Požadavky se pak podepisují hlavičkou `Shoptet-Private-API-Token`. **Veřejné API pro doplňky** používají partneři, kteří vyvíjejí doplňky do katalogu Shoptetu. Přihlášení jde přes **OAuth 2**: při instalaci doplňku e-shop schválí, ke kterým skupinám dat má doplněk přístup, a doplněk si pak vyžádá dočasný přístupový token. Tímhle způsobem fungují všechny doplňky z [doplnky.shoptet.cz](https://doplnky.shoptet.cz/) a díky tomu se napojení na API dostane i k e-shopům na běžných tarifech — jen ne „na míru", ale v podobě hotového doplňku. Prakticky to znamená: - **Máte Shoptet Premium a chcete vlastní napojení** — privátní API a vlastní token pro každého partnera. - **Jste na běžném tarifu** — privátní token nevytvoříte. Napojení se řeší doplňkem z katalogu, který používá veřejné API. - **Vyvíjíte doplněk pro víc e-shopů** — veřejné API a OAuth, podmínky pro partnery má Shoptet na [developers.shoptet.com](https://developers.shoptet.com/). ## Co Shoptet API pokrývá Dokumentace dělí endpointy do tematických skupin. Ve zkratce: - **Produkty** — produkty a varianty, obrázky, ceny, dostupnost, související produkty a sady. - **Kategorie** — strom kategorií a zařazení produktů. - **Objednávky** — objednávky s položkami, platbou, dopravou, stavy a historií. - **Účetnictví** — faktury, dobropisy, dodací listy a zálohové faktury. - **Zákazníci** — zákaznické účty, doručovací adresy a zákaznické skupiny. - **Sklad** — zásoby, více skladů a skladové pohyby. - **Marketing** — slevové kupóny, množstevní slevy a opuštěné košíky. - **Obsah** — články, stránky a hodnocení. - **Nastavení** — platby, dopravy, DPH, číselníky a prodejní kanály. Každému privátnímu tokenu se přiřazují skupiny endpointů s právem ke čtení, k zápisu, nebo k obojímu. Pozor na výchozí stav: **nový token má automaticky všechna práva** — všechny skupiny a přístup ke všem endpointům. Omezit je jde v administraci: skupiny, které partner nepotřebuje, mu odeberte — kdo jen stahuje objednávky do účetnictví, nemusí mít právo měnit produkty. Přesný seznam endpointů a polí najdete v dokumentaci — mění se a přibývá, takže ho tady schválně nepřepisujeme. ## Webhooky a asynchronní úlohy Napojení se nemusí pořád dokola ptát, jestli se v e-shopu něco změnilo. Přes API si zaregistrujete **webhooky** a e-shop sám pošle zprávu na vaši adresu, když vznikne nová objednávka, změní se produkt, proběhne skladový pohyb nebo se vystaví doklad. Napojení pak reaguje hned a zbytečně nezatěžuje e-shop ani sebe. Některé požadavky trvají déle — typicky hromadné operace nebo export velkého množství dat najednou. Ty Shoptet zpracovává **asynchronně**: požadavek zařadí do fronty, a když je hotový, dá vědět webhookem `job:finished`. Výsledek si napojení vyzvedne přes detail úlohy. Podle dokumentace se úloha, která se do tří hodin od vytvoření nedokončí, označí jako neúspěšná. Kdo s asynchronními požadavky počítá, potřebuje mít webhooky nastavené dřív, než je začne posílat. ## Limity, se kterými je potřeba počítat Shoptet podle dokumentace neomezuje počet dotazů ani objem přenesených dat. Limity jsou nastavené jako ochrana proti přetížení serveru a týkají se hlavně **souběžných spojení**: - **nejvýš 3 současná spojení na jeden token,** - **nejvýš 50 současných spojení z jedné IP adresy,** - **nejvýš 10 privátních tokenů na jeden e-shop.** Když napojení limit překročí, API vrátí chybu 429 a v odpovědi řekne, za jak dlouho to zkusit znovu. Zátěž se navíc průběžně měří (Shoptet k tomu používá algoritmus „leaky bucket") a každá odpověď nese hlavičku s tím, jak moc je kapacita zaplněná. Dobře napsané napojení na tuhle hlavičku reaguje a samo zpomalí. Z toho plyne praktické pravidlo: **každý partner a každá integrace má mít vlastní token.** Dvě napojení na jednom tokenu si berou spojení navzájem a vzájemně se brzdí. Protože tokenů je nejvýš 10, nepoužívané průběžně mažte — třeba po partnerovi, se kterým už nespolupracujete. Další věci, které je dobré vědět dopředu: - **API je rozhraní k datům, ne hotové napojení.** Samotný klíč nic nesynchronizuje. Vždycky je potřeba program, který API volá, zpracuje odpovědi, ohlídá chyby a někdo ho udržuje. - **Přes API zákazníkovi nic nezobrazíte.** Když má zákazník na e-shopu vidět něco nového, potřebujete k API ještě vlastní kód v šabloně e-shopu. - **Verze v adrese nejsou.** Shoptet API rozšiřuje průběžně a endpointy, které chce zrušit, předem označí hlavičkou o ukončení. Napojení má proto počítat s tím, že v odpovědích přibudou nová pole. ## Jak začít krok za krokem 1. **Vytvořte API klíč.** V administraci Shoptet Premium v sekci Propojení → Private API. Celý postup se screenshoty je v návodu [Jak vytvořit Shoptet Premium API klíč](https://www.webotvurci.cz/navody/shoptet-premium/jak-vytvorit-shoptet-premium-api-klic/). 2. **Sepište, co má napojení dělat.** Která data, kterým směrem a jak často. Z toho vyplyne, jaké skupiny endpointů a práva token potřebuje. Nový token má automaticky všechny, ty nepotřebné mu odeberte. 3. **Projděte dokumentaci.** Na [api.docs.shoptet.com](https://api.docs.shoptet.com/shoptet-api/openapi) najdete popis všech endpointů, základní principy (autentizace, stránkování, chyby, limity), kolekci pro Postman i odkaz na SDK. 4. **Vyzkoušejte si první požadavky.** Nejrychleji v Postmanu nebo podobném nástroji: hlavička `Shoptet-Private-API-Token` s vaším klíčem a adresa `https://api.myshoptet.com`. Začněte čtením, třeba výpisem objednávek, a zápisy přidejte, až víte, co vrací. 5. **Nastavte webhooky** pro události, na které má napojení reagovat, a počítejte s asynchronními úlohami u hromadných operací. 6. **Ošetřete limity a chyby.** Odpověď 429, výpadek spojení, neplatná data. Napojení, které běží roky, se pozná podle toho, jak se chová, když se něco pokazí. ## API, nebo oficiální Shoptet MCP? Od 29. 7. 2026 má Shoptet Premium oficiální **Shoptet MCP** — hostovaný server, přes který se AI asistent (Claude, ChatGPT a další) připojí k datům e-shopu. Přihlašuje se přes OAuth, ne API klíčem, umí číst data a dělat omezené zápisy. Mazání ani hromadné změny záměrně neumí. Kdy co: - **API** je pro **trvalá napojení systémů** — synchronizace, která běží sama, bez člověka, a kde potřebujete plnou kontrolu nad tím, co se čte a zapisuje. - **MCP** je pro **práci člověka s AI** — zeptat se na objednávky, sklad nebo prodeje běžnou řečí a nechat asistenta připravit kupón nebo upravit popisek. Podrobně MCP rozebíráme v článku [Shoptet MCP: propojte AI přímo s administrací svého e-shopu](https://www.webotvurci.cz/blog/shoptet-mcp-server-ai/). ## Co se přes Shoptet API typicky staví Pár příkladů napojení, která přes API dávají smysl: - **Napojení skladu nebo WMS** — skladový systém dostává objednávky k vychystání a vrací do e-shopu stav zásob a stav expedice. - **Automatizace objednávek** — změna stavu objednávky podle platby nebo expedice, předání objednávek a dokladů dalším systémům, upozornění, když se objednávka zasekne. - **Synchronizace produktů** — ceny, dostupnost a popisy z dodavatelských podkladů nebo z vašeho interního systému, včetně napojení na účetní či ERP systém, pokud ho firma používá. - **Reporting** — prodeje, marže a zásoby do vlastních přehledů nebo tabulek, bez ručních exportů. - **Vlastní moduly pro e-shop** — kde se API kombinuje s kódem v šabloně, třeba [widget výdejních míst](https://www.webotvurci.cz/sluzby/shoptet/shoptet-premium-e-shop-bez-limitu/dopravy-na-miru-pro-shoptet-premium/) nebo [výpočet dopravného](https://www.webotvurci.cz/sluzby/shoptet/shoptet-premium-e-shop-bez-limitu/vypocet-dopravneho-na-miru-pro-shoptet-premium/) na míru. ## Časté otázky ### Kdo může Shoptet API používat? Privátní API je součástí Shoptet Premium — token v administraci vytvoří jen e-shop na Premiu, a to nejvýš 10 tokenů. Běžný Shoptet privátní API nemá. Napojení tam jde jen přes doplňky z katalogu, které používají veřejné API. ### Mám Shoptet API i na běžném tarifu? Privátní token ne, ten je jen pro Premium. Na běžném tarifu se k API dostanete nepřímo, přes doplňky z katalogu, které používají veřejné API s přihlášením přes OAuth. ### Kde najdu dokumentaci Shoptet API? Na [api.docs.shoptet.com](https://api.docs.shoptet.com/shoptet-api/openapi). Je v angličtině, obsahuje popis všech endpointů, základní principy, kolekci pro Postman i odkaz na SDK. Informace pro vývojáře doplňků jsou na [developers.shoptet.com](https://developers.shoptet.com/). ### Kolik požadavků na API můžu poslat? Počet požadavků ani objem dat Shoptet podle dokumentace neomezuje. Omezený je počet současných spojení: 3 na jeden token a 50 z jedné IP adresy. Při přetížení API vrátí chybu 429. ## Potřebujete napojení na míru? Vytvořit klíč a poslat první požadavek je otázka odpoledne. Postavit napojení, které spolehlivě běží roky, ohlídá limity a nerozbije se při první změně, je jiná práce. Jako Shoptet Premium partner stavíme nad API [automatizace](https://www.webotvurci.cz/sluzby/shoptet/shoptet-premium-e-shop-bez-limitu/automatizace-pro-shoptet-premium/), napojení na další systémy i vlastní moduly. Podívejte se, co stavíme na [Shoptet Premium na míru](https://www.webotvurci.cz/sluzby/shoptet/shoptet-premium-e-shop-bez-limitu/), nebo nám [napište](https://www.webotvurci.cz/kontakt/), co potřebujete propojit. Řekneme, jestli to jde přes API, kolik to bude stát a jak dlouho to potrvá. --- *Návod pochází z webu Webotvůrci — Zlatý a Premium partner Shoptetu.* *Všechny návody: https://www.webotvurci.cz/navody/ · Kontakt: jsme@webotvurci.cz*