API klíče: režimy, oprávnění a povolené IP adresy
API přístup vytvoříte v API a integrace na záložce API přístupy: zadáte název, zvolíte režim, platnost a oprávnění a klíč si uložíte. Odkud smí volání přijít, omezíte povolenými IP adresami. API je jen v placených tarifech, tarif Free ho nemá.
Bez placeného tarifu stránka API a integrace ukáže hlášku API a integrace jsou dostupné jen v placeném tarifu. Tarif si objednáte v části Tarif a fakturace, ceny najdete na stránce Ceník. Dříve vytvořené přístupy po přechodu na tarif s API začnou znovu fungovat bez výměny klíče.
Co je přístup a co je klíč
Jeden API přístup (integrace) má název, režim, platnost a oprávnění. K přístupu patří klíč, kterým se váš systém při volání API přihlásí. Celý klíč uvidíte jen jednou, hned po vytvoření.

Vytvoření přístupu
- V levém menu projektu otevřete API a integrace a záložku API přístupy.
- Zvolte Přidat integraci. Když zatím žádný přístup nemáte, je tlačítko i v prázdném stavu seznamu.
- Zadejte název, vyberte režim, platnost a oprávnění. Oprávnění jsou seskupená podle oblastí.
- V okně Integrace vytvořena zvolte Kopírovat klíč a uložte ho bezpečně mimo zdrojový kód. Po zavření okna ho už znovu nezobrazíme.
Testovací a ostrý režim
Začněte přístupem v režimu Testovací. Volání jen nasimuluje a neodešle e-mail ani webhook a nezmění ostré kontakty. Pozor: čtení se nesimuluje. Testovací klíč vrací skutečná data projektu v rozsahu svých oprávnění, proto ho chraňte stejně jako ostrý. Až test projde, vytvořte ostrý přístup a klíč ve své aplikaci vyměňte. První zprávu přes API popisuje návod Transakční e-mail přes API.
Oprávnění
Oprávnění určují, co smí klíč dělat. Dejte klíči jen ta, která váš systém opravdu potřebuje. Například právo řídit celý projekt nepřidělujte jen kvůli odesílání zpráv.
Oprávnění změníte v detailu přístupu volbou Upravit oprávnění. Nabízí Označit vše, Zrušit výběr a počet vybraných oprávnění. Po Uložit změny platí pro všechny klíče přístupu bez jejich výměny. Již přijaté zprávy pokračují.
Platnost, pozastavení a zneplatnění
V seznamu vidíte u každého přístupu režim, platnost, kdy byl naposledy použit a stav (Aktivní, Pozastavená, Zrušená). V nabídce … u přístupu najdete:
- Pozastavit a Obnovit. Platí hned.
- Zneplatnit přístup. Aplikace se zeptá na potvrzení. Zrušený přístup nelze obnovit a nové požadavky se odmítají. Již přijatá práce pokračuje.
Výměna klíče
V detailu přístupu otevřete Správa přístupu a klíčů. Najdete tam pozastavení, obnovení, náhradní klíče a historii. Postup výměny: vytvořte náhradní klíč, vložte ho do svého systému a starý klíč zrušte. Zrušené klíče jsou ve výchozím stavu skryté v Historii zrušených klíčů. Po zrušení posledního klíče můžete u nezrušeného přístupu vytvořit náhradní.
Povolené IP adresy
Ve Správě přístupu a klíčů můžete nastavit Povolené IP adresy. Zadejte jednu adresu nebo rozsah na řádek, nejvýše 20 položek. Prázdné pole znamená bez omezení. Po uložení přijímá API požadavky jen z vyjmenovaných adres, a to pro všechny klíče přístupu včetně náhradního. Požadavek odjinud skončí chybou 403 ip_not_allowed. Okno ukáže adresu, ze které právě pracujete, a Přidat mou adresu ji doplní.
Když to nejde
- Požadavek odmítnutý, nebo přístup nejde vytvořit. Zkontrolujte tarif. Free API nemá a server odmítne volání chybou
api_plan_required. - Chyba
403 ip_not_allowed. Adresa, ze které systém volá, není mezi povolenými. Doplňte ji, nebo omezení vymažte. - Hláška Podezřelá aktivita API klíčů. Když klíč během 5 minut 20krát požádá o cizí projekt nebo operaci bez oprávnění, API další takové požadavky na 15 minut odmítá. Pokud požadavky neposílá váš systém, klíč mohl uniknout: zneplatněte ho a vytvořte nový.
- Klíč jste ztratili. Zobrazit ho znovu nejde. Vytvořte náhradní klíč.
Vývojáři při chybě předejte HTTP stav, code, request_id a případná fields, nikdy klíč.
Časté dotazy
Smím klíč poslat vývojáři e-mailem nebo do chatu?
Ne, klíč se nesdílí. Patří jen do zabezpečeného úložiště vašeho systému, například do proměnné prostředí. Vývojáři raději vytvořte vlastní přístup s minimem oprávnění, který můžete kdykoli pozastavit.
Kde najdu popis všech požadavků a chyb?
Ve veřejné dokumentaci API. Odkaz na ni je také v aplikaci v API a integrace (Dokumentace API).
Mám hotové napojení na svůj e-shop?
Hotová napojení na konkrétní e-shopy aplikace nenabízí. Váš systém volá API sám. Plánované funkce najdete na stránce Co chystáme.
Další krok
Co všechno API umí, shrnuje stránka API a integrace. Pokračujte návodem Webhooky: události o doručení do vašeho systému.
Nevíte si rady? V aplikaci se zeptejte AI pomocníka nebo napište podpoře. Jak podpora funguje