Registrace

Funkce

API a headless režim — obsah pro jakýkoli frontend

REST API nad obsahem, katalogem i uživateli. Administraci dostane klient hotovou, frontend si napíšete v čem chcete — a o každé změně vám dáme vědět sami.

Vyzkoušet zdarma Nápověda API

Jedno obsahové jádro napojené na několik různých frontendů

Dnes

Limit tradičních CMS

Frontend je pevně svázaný s administrací. Vlastní JS framework nebo no-code nástroj znamená boj se šablonovacím systémem.

S Mini-webem

Plnohodnotné REST API nad obsahem, katalogem i uživateli. Publikační jádro se stará o data, vy tvoříte libovolný frontend.

Rozsah

Co API pokrývá

  • Obsah

    Články, stránky, rubriky, štítky a média — čtení i zápis.

  • E-shop

    Produkty, varianty, sklad, košík, objednávky i kupony. Přes API projde celý nákup, ne jen výpis zboží.

  • Uživatelé a oprávnění

    Registrace, přihlášení, profily a role. Celý uživatelský portál je dostupný i programově.

  • Formuláře

    Definice formulářů i odeslané zprávy. Formulář tedy může žít i na vašem frontendu.

  • Webbuilder

    Sekce, stránky, vzhledy i projekty AI Studia. Builder jde řídit z vlastního nástroje.

  • Efektivní přenosy

    ETag a podmíněné dotazy, gzip komprese. Když se nic nezměnilo, nestahujete data znovu.

Odpověď API na dotaz GET /api/v1/articles — status 200 a JSON s poli id, title, slug a dalšími
Běžný dotaz na výpis článků a jeho odpověď — obyčejný JSON, žádný proprietární formát.

Webhooky

O změnách se dozvíte sami

Nemusíte se API pravidelně ptát, co je nového. Jakmile se něco stane, pošleme zprávu na vaši adresu — frontend tak může zareagovat v okamžiku vydání, ne až při příštím naplánovaném buildu.

  • Publikace obsahu

    Vyjde článek nebo se změní rubrika a váš frontend to ví hned. Statický web přegenerujete jen tam, kde se opravdu něco změnilo.

  • Přejmenovaná adresa se uklidí

    Když se změní adresa stránky, pošleme vám i tu původní. Na staré cestě tak nezůstane viset zastaralá kopie, o které nikdo neví.

  • Objednávky do účetnictví

    Vytvoření, zaplacení, odeslání i storno. Napojení na účetní systém nebo sklad postavíte tak, že se do administrace nemusí dívat vůbec nikdo.

  • Formuláře rovnou do CRM

    Odeslaný formulář dorazí i s vyplněnými poli, takže ho nasměrujete kamkoli. Odeslání vyhodnocená jako spam neposíláme.

  • Podepsané a ověřitelné

    Každá zpráva nese podpis, podle kterého poznáte, že přišla opravdu od nás a cestou se nezměnila.

  • Když to jednou nevyjde

    Neúspěšné doručení opakujeme v prodlužujících se odstupech. Pokud vaše adresa delší dobu neodpovídá, odesílání pozastavíme a dáme vám vědět e-mailem.

U každého odeslání vidíte v administraci, co jsme poslali, co přišlo zpátky a jak dlouho to trvalo. Integraci si tedy odladíte sami a kteroukoli zprávu můžete poslat znovu — bez psaní na podporu.

Správa webhooků — dva endpointy s vybranými událostmi a log doručení s úspěšnými i neúspěšným odesláním
U endpointu si vyberete události, které chcete odebírat. V logu je pak u každého odeslání stav, návratový kód i doba odezvy — a když něco neprojde, i důvod.

Autentizace a limity

Přístup pod kontrolou

  • Klíče s omezeným rozsahem

    Klíč dostane buď plný přístup, jen čtení, nebo přesně vybrané oblasti webu. Platnost si nastavíte při vytvoření. Žádné sdílení hesla do administrace.

  • Vidíte, co se používá

    U každého klíče je poslední použití a zbývající platnost. Nepoužívaný přístup poznáte a zrušíte.

  • Limity, které znáte předem

    Tisíc čtecích a sto zapisovacích dotazů za hodinu. Zbývající počet i čas do obnovení posílá API v hlavičkách, takže na limit můžete aplikaci navrhnout, ne ho objevovat za provozu.

  • CORS podle webu

    Povolené originy nastavujete pro každý web zvlášť, takže frontend na vlastní doméně funguje bez obcházení prohlížeče.

Správa API klíčů — volba oprávnění, nastavení platnosti a přehled klíčů s posledním použitím
Klíč si vytvoříte sami — vyberete rozsah práv i platnost a u vydaných klíčů vidíte, kdy se naposledy použily.

Jak začít

Headless start za čtyři kroky

  • Založíte web a vyberete prázdnou šablonu — web tím nic nevykresluje a slouží jen jako obsahové jádro.
  • Vygenerujete klíč s právy, která váš frontend potřebuje.
  • Čtete data přes API a obsah spravujete dál v administraci, kterou dostane i klient.
  • Zapnete si upozornění na změny — vyberete události, které chcete odebírat, a zadáte adresu, kam je posílat. Frontend pak reaguje sám.
Dokumentace rozsahů oprávnění — hierarchický systém scopes ve tvaru resource:action
Oprávnění mají tvar zdroj:akce a jsou hierarchická — kdo smí zapisovat, smí i číst. Celý seznam je v nápovědě.

Komu je API určené

Kdo z headless režimu těží

Otázky

Časté otázky k API

Jaké jsou limity API?

Tisíc čtecích a sto zapisovacích dotazů za hodinu na web, čtení a zápis mají oddělené limity. V odpovědi chodí hlavičky se zbývajícím počtem i časem do obnovení. Odpovědi podporují ETag, takže nezměněná data nestahujete opakovaně.

Jak dlouho platí přístupový klíč?

Platnost si nastavíte při vytvoření — rychlé volby jsou 30 dní, 90 dní, rok a dva roky, případně zadáte vlastní počet dní. U každého klíče vidíte zbývající platnost i poslední použití.

Dozvím se, když vyjde nový článek?

Ano. Systém pošle zprávu na vaši adresu ve chvíli, kdy článek vyjde — včetně plánované publikace. Odebírat můžete i změny rubrik, objednávek a odeslané formuláře, buď po jednotlivých událostech, nebo celé skupiny naráz.

Co když můj server zrovna neběží?

Doručení opakujeme v prodlužujících se odstupech, takže krátký výpadek nic neztratí. Když adresa neodpovídá dlouhodobě, odesílání pozastavíme a pošleme e-mail — po opravě ho zase zapnete.

Nezahltí mě jednorázový import tisíce článků?

Ne. Při migraci z jiného systému se odesílání umlčí, takže vám hromadný import nevygeneruje tisíc zpráv.

Můžu přes API i zapisovat?

Ano, rozsah práv se řídí tarifem: v nižších je API jen pro čtení, ve vyšších i pro zápis.

Můžu obsah spravovat v administraci a zobrazovat vlastním frontendem?

Přesně na to je headless režim. Klient pracuje v administraci, kterou zná, a vaše aplikace si data čte přes API.

Funguje to s no-code nástroji?

Ano. API je běžné REST, takže se dá napojit i na nástroje typu Lovable nebo Bubble.

Dostupnost

Rozsah API se řídí tarifem — v nižších je dostupné pro čtení, ve vyšších pro čtení i zápis. Odchozí webhooky jsou součástí tarifů s plným API přístupem. Aktuální rozsah najdete v ceníku.

Přečtěte si specifikaci

Založte si účet zdarma, vygenerujte klíč a zavolejte první endpoint. Ověříte si to na vlastních datech dřív, než začnete cokoli stavět.

Vyzkoušet zdarma Nápověda API