Shoptet API: co umí, limity a jak začít

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, 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íč. 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 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.

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

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íč.
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.
Projděte dokumentaci. Na api.docs.shoptet.com najdete popis všech endpointů, základní principy (autentizace, stránkování, chyby, limity), kolekci pro Postman i odkaz na SDK.
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í.
Nastavte webhooky pro události, na které má napojení reagovat, a počítejte s asynchronními úlohami u hromadných operací.
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.

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 nebo výpočet dopravného 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. 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.

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, napojení na další systémy i vlastní moduly.

Podívejte se, co stavíme na Shoptet Premium na míru, nebo nám napište, co potřebujete propojit. Řekneme, jestli to jde přes API, kolik to bude stát a jak dlouho to potrvá.