+420 728 089 029EN

Jak vytvořit Shoptet Premium API klíč

⏱ 4 min čtení

Pro efektivní napojení na externí systémy, automatizaci procesů nebo přístup k datům z vašeho e-shopu je nutné mít správně vygenerovaný API klíč v Shoptet Premium. Tento klíč slouží jako unikátní identifikátor a bezpečnostní prvek, který umožňuje komunikaci mezi vaším Shoptet obchodem a dalšími službami – například ERP systémy, skladovým hospodářstvím, nástroji pro e-mail marketing nebo analytickými nástroji.

V tomto návodu si ukážeme, jak si takový Shoptet Private API klíč vytvořit a kde ho najdete. Správná konfigurace API je klíčová nejen pro vývojáře, ale i pro SEO specialisty, kteří využívají data k měření výkonu e-shopu nebo analýze zákaznického chování. Využitím API získáte přístup k produktům, objednávkám, zákazníkům a dalším klíčovým údajům, které lze dále zpracovávat, analyzovat a optimalizovat pro zvýšení konverzního poměru a organické návštěvnosti.

Postup vytvoření API klíče

  1. Přejděte do záložky: Propojení → Private API

Administrace Shoptetu – sekce Propojení → Private API se seznamem API tokenů

  1. Klikněte na „PŘIDAT"

Stránka Private API se zvýrazněným tlačítkem PŘIDAT pro vytvoření nového tokenu

  1. Zadejte název partnera – tak abyste věděli, kdo pod daným API klíčem pracuje

Dialog Přidat privátní token – vyplnění pole Název tokenu názvem partnera

  1. Klikněte na „PŘIDAT"

  2. Zobrazí se vám API klíč – po kliknutí na něj se zobrazí konkrétní klíč

Tabulka Aktivní tokeny s nově vytvořeným API klíčem partnera

  1. Zadejte heslo k účtu, ke kterému jste právě přihlášeni do Shoptetu

Dialog Zobrazit privátní token – zadání hesla k účtu pro zobrazení klíče

  1. API klíč se vám zobrazí – pošlete jej partnerovi

Zobrazený kompletní API klíč v tabulce Aktivní tokeny připravený ke zkopírování

Klíč předávejte jen tomu, kdo ho opravdu potřebuje, a každému partnerovi vytvořte vlastní — v seznamu aktivních tokenů pak podle názvu vidíte, kdo pod kterým klíčem pracuje.

Co Shoptet Premium API umí a neumí

Než klíč někomu pošlete, hodí se vědět, co s ním reálně jde udělat. Vycházíme z oficiální dokumentace Shoptet API a z vlastních napojení. Širší přehled — rozdíl mezi privátním API a API pro doplňky, asynchronní úlohy a jak začít s vlastním napojením — najdete v průvodci Shoptet API.

Co umí

  • Přístup k datům e-shopu přes REST API ve formátu JSON. Privátní API je dostupné jen pro Shoptet Premium. Doplňky z katalogu používají jiný režim (veřejné API s přihlášením přes OAuth).
  • Oprávnění po skupinách. Každému tokenu se přiřazuje jedna nebo víc skupin endpointů s právem ke čtení, k zápisu, nebo k obojímu. Nový token má ve výchozím stavu všechna práva, proto mu ta nepotřebná po vytvoření odeberte. Partner, který jen čte objednávky do účetnictví, nemusí mít právo měnit produkty.
  • Široký záběr dat:
    • produkty včetně variant, obrázků, dostupnosti, cen, souvisejících produktů a sad,
    • objednávky s položkami, platbou, dopravou a historií,
    • zákazníci, jejich doručovací adresy a zákaznické skupiny,
    • doklady — faktury, dobropisy, dodací listy a zálohové faktury,
    • sklad včetně více skladů a skladových pohybů,
    • slevové kupóny, množstevní slevy a opuštěné košíky,
    • obsah — články, stránky a hodnocení,
    • nastavení plateb, doprav a DPH.
  • Webhooky. E-shop sám dá vědět, když se něco stane — nová objednávka, změna produktu, skladový pohyb, nový doklad. Integrace se tak nemusí pořád dokola ptát, jestli je něco nového. Některé náročnější požadavky běží asynchronně a na jejich dokončení upozorní právě webhook.

Kde má limity

  • Souběžná spojení. Na jeden token jdou nejvýš 3 současná spojení, z jedné IP adresy nejvýš 50. Počet dotazů ani objem dat Shoptet jinak neomezuje, zátěž ale hlídá a při přetížení integraci přibrzdí. Proto má smysl dávat každému partnerovi vlastní token — dvě integrace na jednom tokenu si berou spojení navzájem.
  • Nejvýš 10 tokenů na e-shop. Víc privátních tokenů na jeden e-shop nevytvoříte, takže ty nepoužívané (třeba po bývalém partnerovi) mažte.
  • API je rozhraní k datům, ne hotové napojení. Samotný klíč nic nesynchronizuje. Napojení na ERP nebo sklad je vždycky program, který API volá, zpracuje odpovědi a ohlídá chyby — a někdo ho musí napsat a udržovat.
  • Samo nic nezobrazí zákazníkovi. Přes API čtete a zapisujete data. Když má zákazník v objednávce vidět něco nového — mapu výdejních míst nebo cenu dopravy spočítanou vlastním vzorcem —, potřebujete k API ještě vlastní kód v e-shopu. I ten Shoptet Premium umožňuje, ale je to další kus práce.
  • Na běžných tarifech ho nemáte. Privátní API je výhoda Premia. Na běžném Shoptetu privátní token nevytvoříte a napojení se řeší typicky přes doplňky z katalogu, které používají veřejné API.

API, nebo Shoptet MCP?

Pokud chcete s daty e-shopu pracovat přes AI asistenta — ptát se na objednávky, sklad nebo prodeje v Claude či ChatGPT —, API klíč nepotřebujete. Od 29. 7. 2026 má Shoptet Premium oficiální Shoptet MCP, které se přihlašuje přes OAuth, ne tokenem, a umí číst data a dělat omezené zápisy. Podrobně to rozebíráme v článku Shoptet MCP: propojte AI přímo s administrací svého e-shopu. API klíč je pro trvalá napojení systémů, MCP pro práci člověka s AI.

Potřebujete napojení na míru?

Vytvořit klíč je pět minut. Postavit nad ním napojení, které poběží roky, je jiná disciplína. Jako Premium partner řešíme napojení na váš systém přes API a stavíme nad ním vlastní moduly — třeba widget výdejních míst, výpočet dopravného nebo automatizace.

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