Rocketoo MAX REST API

Vaše data. Vaše systémy. Vaše pravidla.

Otevřené REST API pro každý e-shop Rocketoo MAX. Propojte ho s ERP, účetnictvím, CRM, marketplace nebo vlastní aplikací. Získejte plnou kontrolu nad produkty, objednávkami, zákazníky i doklady v reálném čase.

REST
moderní rozhraní pro každý jazyk a platformu
100 %
všechny klíčové agendy e-shopu pokrývá API
0 Kč
API je součástí Rocketoo MAX bez příplatku
Rest API

Co je Rocketoo MAX API

Rocketoo MAX REST API otevírá váš e-shop okolnímu světu. Tvoří jednotné rozhraní, přes které čtete, zapisujete, upravujete a mažete data přímo v reálném čase — produkty, varianty, kategorie, zákazníky, objednávky, faktury, dobropisy, dodací listy i obsah blogu. Postaveno na standardu OpenAPI 3.1, autentizace probíhá pomocí API klíče v hlavičce, komunikace běží v UTF-8 a všechny odpovědi přicházejí ve formátu JSON. Pro vývojáře vašeho ERP, účetního systému nebo interní aplikace mluví jazykem, kterému okamžitě rozumí.

Standardní REST a JSON

Standardní REST a JSON

Žádný proprietární protokol. Standardní HTTP metody, status kódy a JSON. Cokoliv, co umí síťovou komunikaci, se s API domluví.

Autentizace přes API klíč

Autentizace přes API klíč

Bezpečná autentizace přes hlavičku x-api-key. Klíče vystavujete a spravujete v administraci — každý napojení dostane vlastní.

Plně dokumentované

Plně dokumentované

Kompletní OpenAPI specifikace s ukázkami požadavků i odpovědí. Vývojář vašeho dodavatele integrací nasadí během dní, ne týdnů.

Klíčové funkce

Co všechno API umí

REST API pokrývá kompletní datový ekosystém Rocketoo MAX. Od produktového katalogu přes objednávky a doklady až po blogový obsah — všechno klíčové, co e-shop denně řeší, je přístupné přes API.

Produkty a varianty

Vytvářejte, čtěte, upravujte a mažte produkty i jejich varianty. Hromadné aktualizace variant zvládnete jediným voláním — ideální pro synchronizaci skladových stavů a cen z ERP.

Objednávky a doklady

Stahujte objednávky včetně všech detailů, měňte jejich stavy, aktualizujte parametry dopravy nebo si stáhněte PDF doklad. API zpřístupňuje také faktury, proformy, dobropisy a dodací listy.

Zákazníci a adresy

Spravujte zákazníky včetně jejich adres. Vytvářejte nové účty, aktualizujte existující. CRM nebo věrnostní systém získá data, která potřebuje, bez prodlevy.

Číselníky a nastavení

Přes API čtete kategorie, příznaky, skupiny produktů, dopravce, platební metody i stavy objednávek. Vaše integrace pracují vždy s aktuálními daty e-shopu — bez duplicitního vyplňování.

Blog a obsah

Články, autory a kategorie blogu zpřístupňuje API stejně jako e-shopová data. Publikujte z externího redakčního systému nebo synchronizujte obsah napříč více kanály.

Eshop a healthcheck

Endpoint pro ověření dostupnosti API, výpis povolených endpointů a informace o e-shopu samotném. Monitoring vašich integrací má vše, co potřebuje.

Výhody

Proč Rocketoo MAX API

Rozhraní, které ulehčí život vývojářům i provozovatelům.

  • Real-time, ne dávkově

    Data čtete i zapisujete okamžitě. Žádné noční dávky, žádné čekání na další synchronizační okno. Stav objednávky změníte hned.

  • Stránkování a filtrace

    Většina GET endpointů podporuje stránkování i filtraci podle ID, data vytvoření, aktivního stavu nebo dalších parametrů. Stahujete přesně to, co potřebujete, bez zbytečné zátěže.

  • Předvídatelné chybové stavy

    Standardní HTTP status kódy, jasné chybové zprávy v JSON. Vývojář ošetří chybové stavy přesně podle dokumentace.

  • Granulární oprávnění

    Pro každý API účet nastavíte, k jakým endpointům a metodám má přístup. Účetní systém čte objednávky, marketplace zapisuje skladové stavy, každý podle svého oprávnění.

  • Aktivní podpora

    Stránka API podpory s aktuální dokumentací, kontaktem a tipy pro vývojáře. Pokud se vývojář vašeho dodavatele zasekne, ozve se nám a my pomůžeme.

  • Bez příplatku

    API je součástí každé instalace Rocketoo MAX. Žádné navýšení tarifu, žádné licenční poplatky za počet volání. Integrace si můžete dovolit.
Typické scénáře

Kdo Rest API využije

API nepoužívají jen vývojáři. Hodí se každému, kdo má e-shop a chce, aby s ostatními systémy hladce spolupracoval.

Napojení na ERP nebo účetnictví

Pohoda, ABRA, Money S3, SAP, Microsoft Dynamics nebo cokoliv jiného. Objednávky odcházejí do účetního systému automaticky, faktury a skladové stavy se vrací zpět na e-shop. Žádné ruční přepisování.

Synchronizace s marketplace

Kaufland, Allegro, Heureka, Glami, Amazon nebo eMag. Skladové stavy a ceny aktualizujte v reálném čase, objednávky z marketplace stahujte přes prostředníka přímo do e-shopu.

CRM a marketingová automatizace

HubSpot, Salesforce, ActiveCampaign nebo Mailchimp. Zákazníci, jejich nákupní historie a stavy objednávek tečou do CRM automaticky — segmentace a kampaně pracují s daty maximálně 5 minut starými.

PIM a hromadná správa produktů

Centrální PIM systém spravuje katalog napříč všemi kanály, do Rocketoo MAX synchronizuje produkty, varianty, obrázky i ceny. Změna na jednom místě se promítne všude.

Vlastní mobilní aplikace

Postavte si vlastní iOS nebo Android aplikaci, která čerpá data přímo z e-shopu přes API. Stejný katalog, stejné objednávky, stejné účty zákazníků — jiné rozhraní.

Reporting a BI nástroje

Power BI, Tableau, Looker nebo Metabase. Stahujte data o objednávkách, produktech a zákaznících do datového skladu a stavte na nich reporty, predikce i dashboardy.

Integrace skladového systému

WMS nebo skladový software běží mimo e-shop, ale přes API dostává objednávky k vyskladnění a posílá zpět informace o expedici, sledovací čísla a změny dostupnosti.

Vlastní customizace bez zásahu do jádra

Potřebujete funkci, kterou e-shop standardně neumí? Postavte ji jako externí aplikaci, která s e-shopem komunikuje přes API — bez zásahu do kódu Rocketoo MAX.

Dva přístupy

API vs. tradiční přístup

Integrace přes soubory a noční dávky patří minulosti. Moderní API přináší rychlost, stabilitu a kontrolu, kterou váš e-shop potřebuje.

Tradiční přístup
Rocketoo MAX API
Data exportujete přes CSV nebo XML soubory
Komunikace v reálném čase přes REST
Synchronizace běží jednou denně v noci
Změny se propisují okamžitě
Každá změna formátu znamená přepsání skriptů
Stabilní OpenAPI protokol mezi systémy
Bezpečnost řešíte přístupy k souborům na FTP
Šifrovaná HTTPS komunikace s API klíčem
Chyby zjistíte až ráno z logu
Chyby vidíte okamžitě v odpovědi API
Externí systémy musí přizpůsobovat formáty
Standardní JSON, který chápe každá moderní platforma
Pro vývojáře

Připraveno pro váš dev tým

API stojí na standardech, které vývojáři znají. OpenAPI 3.1 specifikaci si stáhnete v YAML formátu a vygenerujete z ní klienta pro libovolný jazyk — PHP, Python, JavaScript, C#, Go, Ruby, Java. Swagger UI dokumentace vám umožňuje testovat endpointy přímo v prohlížeči. Autentizace, stránkování i chybové kódy odpovídají REST konvencím — žádné překvapení.

API podpora pro vývojáře
FAQ

Časté dotazy k API

Odpovědi na otázky, které vývojáři a provozovatelé řeší nejčastěji — než se pustí do integrace.

Jak získám přístup k API?

V administraci e-shopu otevřete sekci uživatelů API a vytvoříte nový účet. Systém vygeneruje API klíč, který předáte vývojáři vaší integrace. Pro každou integraci doporučujeme vytvořit samostatný účet — usnadní to správu oprávnění i případné odebrání přístupu.

Stojí API něco navíc?

Ne. REST API je standardní součástí každé instalace Rocketoo MAX. Žádné licenční poplatky, žádné limity podle počtu volání nad rámec běžné ochrany proti přetížení.

V jakém jazyce mohu psát integraci?

V jakémkoliv. API mluví HTTP a JSON — což zvládne Python, PHP, JavaScript, C#, Java, Go, Ruby a desítky dalších jazyků. Z OpenAPI specifikace si pomocí veřejných generátorů vytvoříte typovaného klienta pro jazyk, ve kterém pracujete.

Existuje limit počtu volání?

Ano, ale jen jako ochrana proti přetížení. Při překročení rozumného počtu požadavků za minutu vrátí API status 429 Too Many Requests a vývojář musí volání zpomalit. Pro typické integrace s ERP, CRM nebo marketplace je limit dostatečný s velkou rezervou.

Mohu omezit, k čemu má integrace přístup?

Ano. Pro každý API účet nastavíte, k jakým endpointům a HTTP metodám má přístup. Účetní systém tak třeba jen čte objednávky a zapisuje faktury, ale nemůže měnit produkty.

Co se stane, když změníte API?

API verzujeme. Aktuální verze běží pod cestou /api/v1. Případná nová verze poběží paralelně pod novou cestou — vaše integrace nepřestane fungovat ze dne na den.

Nezodpověděli jsme vše, co potřebujete vědět?

Napište nebo zavolejte. Rádi s vámi vaši situaci nezávazně probereme při bezplatné konzultaci a navrhneme řešení přesně pro váš e-shop.

Aleš Rosa
Aleš Rosa
Key Account Manager
Zavolejte nám (po - pá 8-16h)
+420 775 940 635 chceme@rocketoomax.cz

Plánujete integraci?

Propojte e-shop s čímkoliv, co používáte.

Probereme s vámi, jaké integrace dávají smysl pro váš e-shop — a jak rychle je dokážeme rozjet.

Zadejte své údaje, my se vám ozveme a rádi s vámi probereme vaše potřeby a otázky.

Jste agentura zastupující klienta?

Odesláním tohoto formuláře souhlasíte s přijímáním propagačních e-mailů od společnosti Digital Wizards Group s.r.o. týkajících se jejích produktů a služeb. Můžete se kdykoli odhlásit kliknutím na odkaz v dolní části našich e-mailů.