Rocketoo MAX REST API

Vaše dáta. Vaše systémy. Vaše pravidlá.

Otvorené REST API pre každý e-shop Rocketoo MAX. Prepojte ho s ERP, účtovníctvom, CRM, marketplace alebo vlastnou aplikáciou. Získajte plnú kontrolu nad produktmi, objednávkami, zákazníkmi aj dokladmi v reálnom čase.

REST
moderné rozhranie pre každý jazyk a platformu
100 %
všetky kľúčové agendy e-shopu pokrýva API
0 €
API je súčasťou Rocketoo MAX bez príplatku
Rest API

Čo je Rocketoo MAX API

Rocketoo MAX REST API otvára váš e-shop okolitému svetu. Tvorí jednotné rozhranie, cez ktoré čítate, zapisujete, upravujete a mažete dáta priamo v reálnom čase — produkty, varianty, kategórie, zákazníkov, objednávky, faktúry, dobropisy, dodacie listy aj obsah blogu. Postavené na štandarde OpenAPI 3.1, autentizácia prebieha pomocou API kľúča v hlavičke, komunikácia beží v UTF-8 a všetky odpovede prichádzajú vo formáte JSON. Pre vývojárov vášho ERP, účtovného systému alebo internej aplikácie hovorí jazykom, ktorému okamžite rozumejú.

Štandardné REST a JSON

Štandardné REST a JSON

Žiadny proprietárny protokol. Štandardné HTTP metódy, status kódy a JSON. Čokoľvek, čo vie sieťovú komunikáciu, sa s API dohovorí.

Autentizácia cez API kľúč

Autentizácia cez API kľúč

Bezpečná autentizácia cez hlavičku x-api-key. Kľúče vystavujete a spravujete v administrácii — každé napojenie dostane vlastný.

Plne dokumentované

Plne dokumentované

Kompletná OpenAPI špecifikácia s ukážkami požiadaviek aj odpovedí. Vývojár vášho dodávateľa integráciu nasadí počas dní, nie týždňov.

Kľúčové funkcie

Čo všetko API umie

REST API pokrýva kompletný dátový ekosystém Rocketoo MAX. Od produktového katalógu cez objednávky a doklady až po blogový obsah — všetko kľúčové, čo e-shop denne rieši, je prístupné cez API.

Produkty a varianty

Vytvárajte, čítajte, upravujte a mažte produkty aj ich varianty. Hromadné aktualizácie variantov zvládnete jediným volaním — ideálne na synchronizáciu skladových stavov a cien z ERP.

Objednávky a doklady

Sťahujte objednávky vrátane všetkých detailov, meňte ich stavy, aktualizujte parametre dopravy alebo si stiahnite PDF doklad. API sprístupňuje aj faktúry, proformy, dobropisy a dodacie listy.

Zákazníci a adresy

Spravujte zákazníkov vrátane ich adries. Vytvárajte nové účty, aktualizujte existujúce. CRM alebo vernostný systém získa dáta, ktoré potrebuje, bez prieťahov.

Číselníky a nastavenia

Cez API čítate kategórie, príznaky, skupiny produktov, dopravcov, platobné metódy aj stavy objednávok. Vaše integrácie pracujú vždy s aktuálnymi dátami e-shopu — bez duplicitného vypĺňania.

Blog a obsah

Články, autorov a kategórie blogu sprístupňuje API rovnako ako e-shopové dáta. Publikujte z externého redakčného systému alebo synchronizujte obsah naprieč viacerými kanálmi.

E-shop a healthcheck

Endpoint na overenie dostupnosti API, výpis povolených endpointov a informácie o e-shope samotnom. Monitoring vašich integrácií má všetko, čo potrebuje.

Výhody

Prečo Rocketoo MAX API

Rozhranie, ktoré uľahčí život vývojárom aj prevádzkovateľom.

  • Real-time, nie dávkovo

    Dáta čítate aj zapisujete okamžite. Žiadne nočné dávky, žiadne čakanie na ďalšie synchronizačné okno. Stav objednávky zmeníte hneď.

  • Stránkovanie a filtrácia

    Väčšina GET endpointov podporuje stránkovanie aj filtráciu podľa ID, dátumu vytvorenia, aktívneho stavu alebo ďalších parametrov. Sťahujete presne to, čo potrebujete, bez zbytočnej záťaže.

  • Predvídateľné chybové stavy

    Štandardné HTTP status kódy, jasné chybové správy v JSON. Vývojár ošetrí chybové stavy presne podľa dokumentácie.

  • Granulárne oprávnenia

    Pre každý API účet nastavíte, ku ktorým endpointom a metódam má prístup. Účtovný systém číta objednávky, marketplace zapisuje skladové stavy, každý podľa svojho oprávnenia.

  • Aktívna podpora

    Stránka API podpory s aktuálnou dokumentáciou, kontaktom a tipmi pre vývojárov. Ak sa vývojár vášho dodávateľa zasekne, ozve sa nám a my pomôžeme.

  • Bez príplatku

    API je súčasťou každej inštalácie Rocketoo MAX. Žiadne navýšenie tarifu, žiadne licenčné poplatky za počet volaní. Integrácie si môžete dovoliť.
Typické scenáre

Kto Rest API využije

API nepoužívajú len vývojári. Hodí sa každému, kto má e-shop a chce, aby s ostatnými systémami hladko spolupracoval.

Napojenie na ERP alebo účtovníctvo

Pohoda, ABRA, Money S3, SAP, Microsoft Dynamics alebo čokoľvek iné. Objednávky odchádzajú do účtovného systému automaticky, faktúry a skladové stavy sa vracajú späť na e-shop. Žiadne ručné prepisovanie.

Synchronizácia s marketplace

Kaufland, Allegro, Heureka, Glami, Amazon alebo eMag. Skladové stavy a ceny aktualizujte v reálnom čase, objednávky z marketplace sťahujte cez sprostredkovateľa priamo do e-shopu.

CRM a marketingová automatizácia

HubSpot, Salesforce, ActiveCampaign alebo Mailchimp. Zákazníci, ich nákupná história a stavy objednávok tečú do CRM automaticky — segmentácia a kampane pracujú s dátami maximálne 5 minút starými.

PIM a hromadná správa produktov

Centrálny PIM systém spravuje katalóg naprieč všetkými kanálmi, do Rocketoo MAX synchronizuje produkty, varianty, obrázky aj ceny. Zmena na jednom mieste sa premietne všade.

Vlastná mobilná aplikácia

Postavte si vlastnú iOS alebo Android aplikáciu, ktorá čerpá dáta priamo z e-shopu cez API. Rovnaký katalóg, rovnaké objednávky, rovnaké účty zákazníkov — iné rozhranie.

Reporting a BI nástroje

Power BI, Tableau, Looker alebo Metabase. Sťahujte dáta o objednávkach, produktoch a zákazníkoch do dátového skladu a stavajte na nich reporty, predikcie aj dashboardy.

Integrácia skladového systému

WMS alebo skladový softvér beží mimo e-shopu, ale cez API dostáva objednávky na vyskladnenie a posiela späť informácie o expedícii, sledovacie čísla a zmeny dostupnosti.

Vlastná customizácia bez zásahu do jadra

Potrebujete funkciu, ktorú e-shop štandardne nevie? Postavte ju ako externú aplikáciu, ktorá s e-shopom komunikuje cez API — bez zásahu do kódu Rocketoo MAX.

Dva prístupy

API vs. tradičný prístup

Integrácia cez súbory a nočné dávky patrí minulosti. Moderné API prináša rýchlosť, stabilitu a kontrolu, ktorú váš e-shop potrebuje.

Tradičný prístup
Rocketoo MAX API
Dáta exportujete cez CSV alebo XML súbory
Komunikácia v reálnom čase cez REST
Synchronizácia beží raz denne v noci
Zmeny sa prepisujú okamžite
Každá zmena formátu znamená prepísanie skriptov
Stabilný OpenAPI protokol medzi systémami
Bezpečnosť riešite prístupmi k súborom na FTP
Šifrovaná HTTPS komunikácia s API kľúčom
Chyby zistíte až ráno z logu
Chyby vidíte okamžite v odpovedi API
Externé systémy musia prispôsobovať formáty
Štandardný JSON, ktorý chápe každá moderná platforma
Pre vývojárov

Pripravené pre váš dev tím

API stojí na štandardoch, ktoré vývojári poznajú. OpenAPI 3.1 špecifikáciu si stiahnete vo formáte YAML a vygenerujete z nej klienta pre ľubovoľný jazyk — PHP, Python, JavaScript, C#, Go, Ruby, Java. Swagger UI dokumentácia vám umožňuje testovať endpointy priamo v prehliadači. Autentizácia, stránkovanie aj chybové kódy zodpovedajú REST konvenciám — žiadne prekvapenie.

API podpora pre vývojárov
FAQ

Časté otázky k API

Odpovede na otázky, ktoré vývojári a prevádzkovatelia riešia najčastejšie — než sa pustia do integrácie.

Ako získam prístup k API?

V administrácii e-shopu otvorte sekciu API kľúče a vytvorte nový kľúč. Systém vygeneruje API kľúč, ktorý odovzdáte vývojárovi vašej integrácie. Pre každú integráciu odporúčame vytvoriť samostatný účet — uľahčí to správu oprávnení aj prípadné odobratie prístupu.

Stojí API niečo navyše?

Nie. REST API je štandardnou súčasťou každej inštalácie Rocketoo MAX. Žiadne licenčné poplatky, žiadne limity podľa počtu volaní nad rámec bežnej ochrany proti preťaženiu.

V akom jazyku môžem písať integráciu?

V akomkoľvek. API používa štandardné HTTP a JSON — čo zvládne Python, PHP, JavaScript, C#, Java, Go, Ruby a desiatky ďalších jazykov. Z OpenAPI špecifikácie si pomocou verejných generátorov vytvoríte typovaného klienta pre jazyk, v ktorom pracujete.

Existuje limit počtu volaní?

Áno, ale len ako ochrana proti preťaženiu. Pri prekročení rozumného počtu požiadaviek za minútu vráti API status 429 Too Many Requests a vývojár musí volania spomaliť. Pre typické integrácie s ERP, CRM alebo marketplace je limit dostatočný s veľkou rezervou.

Môžem obmedziť, k čomu má integrácia prístup?

Áno. Pre každý API účet nastavíte, ku ktorým endpointom a HTTP metódam má prístup. Účtovný systém tak napríklad iba číta objednávky a zapisuje faktúry, ale nemôže meniť produkty.

Čo sa stane, keď zmeníte API?

API verzujeme. Aktuálna verzia beží pod cestou /api/v1. Prípadná nová verzia pobeží paralelne pod novou cestou — vaša integrácia neprestane fungovať zo dňa na deň.

Neodpovedali sme všetko, čo potrebujete vedieť?

Napíšte alebo zavolajte. Radi s vami vašu situáciu nezáväzne preberieme pri bezplatnej konzultácii a navrhneme riešenie presne pre váš e-shop.

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

Plánujete integráciu?

Prepojte e-shop s čímkoľvek, čo používate.

Preberieme s vami, aké integrácie dávajú zmysel pre váš e-shop — a ako rýchlo ich dokážeme rozbehnúť.

Zadajte svoje údaje, my sa vám ozveme a radi s vami preberieme vaše potreby a otázky.

Ste agentúra zastupujúca klienta?

Odoslaním tohto formulára súhlasíte s prijímaním propagačných e-mailov od spoločnosti Digital Wizards Group s.r.o. týkajúcich sa jej produktov a služieb. Môžete sa kedykoľvek odhlásiť kliknutím na odkaz v dolnej časti našich e-mailov.