Revelor

Pro partnery a vývojáře

API a white-label pro agentury. Vaše šablona zůstane vaše

Revelor pro partnery je white-label režim ekosystému pro Shoptet Premium: jeden lehký skript bez frameworku, který dědí CSS vaší šablony, a k němu veřejné API v1 a klientské rozhraní window.revelor pro napojení vlastních skriptů. Nikde žádné cizí logo. Nasazení se testuje v preview režimu a při výpadku se řízení vrací nativnímu hledání Shoptetu.

Stavíte e-shopy na Shoptet Premium. Poslední, co potřebujete, je cizí skript, který si přebije vaše CSS a rozbije se s každou aktualizací šablony.

Veřejné API

Revelor hlásí, co právě udělal. Vy se na to napojíte jedním řádkem.

// Napojení na události Reveloru (ilustrační ukázka,
// kompletní přehled událostí dostanete při onboardingu)
window.revelor.on('search:results', (payload) => {
    // výsledky vyhledávání jsou vykreslené
});

window.revelor.on('cart:add', (payload) => {
    // zákazník přidal produkt do košíku
});
  • Události, které dávají smysl — vykreslení výsledků hledání, vykreslení doporučení i přidání produktu do košíku. Napojíte vlastní měření, vlastní UI nebo cokoliv, co klient potřebuje.
  • Pozdě načtený skript nic nezmešká — když se váš kód připojí až po Reveloru, dostane poslední stav zpětně. Žádné hlídání pořadí načítání, žádné časovače naslepo.
  • Bez zásahu do jádra — rozšíření píšete vedle Reveloru, ne do něj. Aktualizace na naší straně vám nic nerozbije.

Postaveno tak, aby vám nepřekáželo

Technologie, kterou nemusíte vysvětlovat klientovi ani obhajovat před sebou.

Jeden lehký skript

Na e-shopu běží jediný soubor bez frameworku. Žádný React, žádné jQuery navíc, žádná kolize s tím, co jste do šablony napsali vy.

Dědí CSS vaší šablony

Revelor si bere styly z e-shopu, místo aby si je přebíjel vlastními. Ikony srdce a porovnání kreslíme při instalaci na míru podle nativních ikon šablony.

White-label

Nikde žádné cizí logo, žádný odkaz na dodavatele, žádný podpis v patičce. Zákazník vidí váš e-shop, ne náš produkt.

Preview režim a tiché nasazení

Novou funkci vidí nejdřív jen přihlášený administrátor. Testujete na ostrém provozu, na ostrých datech — a návštěvníci si ničeho nevšimnou.

Fallback na nativní hledání

Revelor si hlídá vlastní dostupnost. Kdyby cokoliv selhalo, vrátí řízení nativnímu vyhledávání Shoptetu — e-shop vašeho klienta nezůstane bez hledání.

Exkluzivně pro Shoptet Premium

Neděláme univerzální krabici pro každou platformu. Revelor zná Shoptet Premium do detailu, včetně chování prémiových šablon.

Exkluzivně pro Shoptet Premium • Ve spolupráci s partnery

FV studio
Boldem
Shean
Brani

Časté otázky

Technické otázky, které padnou dřív, než se podepíše partnerství.

Jak se k veřejnému API přistupuje?

Přes REST rozhraní na adrese vašeho serveru s prefixem /v1; konkrétní adresu dostanete při aktivaci. Každý požadavek nese Bearer token s prefixem rvlr_, který je svázaný s konkrétním e-shopem — Revelor si z něj sám odvodí, o čí data jde. Plná hodnota klíče se zobrazí jen jednou při vytvoření, takže si ji hned bezpečně uložte.

Jak se řídí oprávnění API klíčů?

Každý klíč má vlastní sadu scopes: read:health, read:metrics, read:search, read:recommendations, read:favorites, read:comparison a zápisové write:favorites a write:comparison. Volání mimo rozsah klíče vrací 403 INSUFFICIENT_SCOPE. Klíče lze kdykoli vypsat, přejmenovat, změnit jim oprávnění nebo je deaktivovat — pro každý nástroj tedy můžete mít vlastní klíč s minimem práv.

Jaké platí limity a jak daleko do minulosti data sahají?

Rate limit je 60 požadavků za minutu na jeden klíč v klouzavém okně; každá odpověď nese hlavičky X-RateLimit-Limit, Remaining a Reset a po překročení přijde 429. Metriky a záznamy vyhledávání jsou dostupné za posledních 30 dní, starší období vrací 422. Exporty oblíbených a porovnání jsou výjimka — vracejí aktuální stav, ne log, a časovým oknem omezené nejsou.

Na jaké události se dá napojit přímo na e-shopu?

Klientské rozhraní window.revelor hlásí, co Revelor právě udělal — vykreslení výsledků vyhledávání, vykreslení doporučení i přidání produktu do košíku. Napojíte na ně vlastní měření nebo vlastní UI jedním řádkem. Když se váš skript připojí až po Reveloru, dostane poslední stav zpětně, takže nemusíte hlídat pořadí načítání ani nastavovat časovače naslepo.

Přebije Revelor styly naší šablony?

Ne, je to naopak. Revelor si styly z e-shopu bere, místo aby si je přebíjel vlastními, a na stránce běží jediný lehký JavaScript bez frameworku — žádný React ani jQuery navíc. Ikony srdce a porovnání kreslíme při instalaci na míru podle nativních ikon vaší šablony. Nikde není cizí logo ani podpis v patičce.

Co se stane, když Revelor nebude dostupný?

Frontend má pro odpověď pevný časový limit, u doporučení 200 milisekund. Když ho Revelor nestihne nebo neodpoví, příslušný blok se buď nevykreslí, nebo se zobrazí výchozí výstup Shoptetu — tedy nativní vyhledávání, respektive nativní doporučování. Stránka se nikdy nezasekne a zákazník vašeho klienta výpadek nepozná.

Technické detaily a co číst dál

Nastavení do posledního detailu popisuje veřejná dokumentace Reveloru. Kolik celý ekosystém stojí, si spočítáte v ceníku — a proč si e-shopy na Shoptet Premium vybírají právě Revelor, shrnuje samostatná stránka.

Stavíte e-shopy na Shoptet Premium? Domluvme partnerství.

Revelor nasadíme na e-shopy vašich klientů pod vaší značkou, s ikonami a styly podle vašich šablon. A budete mít přímý kontakt na lidi, kteří ho vyvíjejí.

Objevte zbytek ekosystému