Ak k obchodu pristupujete ako vývojár — staviate vlastný frontend, integrujete AI asistenta, alebo rozširujete platformu témou či pluginom — táto stránka vás nasmeruje priamo na technickú dokumentáciu bez toho, aby ste museli prechádzať obchodnícke návody.
Podľa toho, čo staviate
| Chcem | Začnite tu |
|---|---|
| Postaviť vlastný frontend nad API | Headless storefront — rýchly štart → Headless Storefront API (úplná referencia) |
| Pripojiť Claude alebo iného AI agenta k administrácii | MCP server — pripojenie Claude k obchodu |
| Reagovať na udalosti obchodu (objednávka, vrátenie) vo vlastnom systéme | Webhooky pre vývojárov — payload, podpis a opakovania |
| Postaviť alebo upraviť tému | Vývoj vlastnej témy |
| Napísať plugin (platobná brána, marketingový nástroj, widget) | Vývoj pluginov |
| Rozhodnúť sa medzi zdieľaným a dedikovaným nasadením pre klienta | Prostredia a nasadenie pre klientov |
Čo treba vedieť vopred
- Multi-tenancy. Každý e-shop je samostatná databáza; API aj MCP vyžadujú hlavičku
X-Client-Slug, ktorá určuje, s ktorým obchodom pracujete. - API v1 je len aditívne. Pole ani endpoint sa nikdy neodstráni ani nepremenuje na mieste — bezpečne ignorujte neznáme polia v odpovedi.
- Zápis cez AI/MCP vždy prechádza plánom. Čítacia operácia beží hneď, zápisová sa najprv ukáže ako náhľad a vykoná sa až po potvrdení — rovnaký mechanizmus stojí za AI asistentom v administrácii aj za MCP nástrojmi.
- Zmena vzhľadu vyžaduje SSR build. Po úprave
.tsxsúboru v téme spustitenpm run build:ssr, inak storefront servíruje starý vykreslený strom. - Autentifikácia headless klienta a MCP klienta sú oddelené. Zákaznícky frontend sa prihlasuje cez Sanctum bearer token vydaný pri registrácii/prihlásení; MCP klient (Claude a podobne) používa samostatný token vygenerovaný priamo v administrácii, viazaný na identitu toho, kto ho vygeneroval.
Typické scenáre
Staviam e-shop pre klienta na zdieľanej platforme. Klient si obchod spravuje sám v administrácii, vy pridávate hodnotu cez tému alebo plugin — začnite Vývojom vlastnej témy alebo Vývojom pluginov podľa toho, čo idete meniť.
Klient chce úplne vlastný frontend (napr. Next.js), backend nechá na Ecommio. Toto je presne headless scenár — Headless storefront — rýchly štart vás prevedie chrome obchodu, katalógom, košíkom a pokladňou v jednom sledu volaní.
Klient chce prepojiť obchod s vlastným ERP alebo skladovým systémom. Riešením sú webhooky pre udalosti objednávok a vrátení smerom von, prípadne pravidelný feed import smerom dovnútra — pozri Webhooky pre vývojárov.
Klient chce, aby sa obchod dal ovládať cez AI agenta (Claude a podobne). Nastavte MCP integráciu — token sa generuje priamo v administrácii klienta a agent potom pracuje presne s jeho obchodom, nikdy nie s cudzím.
Klient migruje z inej platformy a chce, aby som mu preniesol dáta hromadne. Toto nie je headless ani API scenár — ide o CSV import produktov; prenáša sa len katalóg, história objednávok a zákazníkov ostáva v pôvodnom systéme, pozri Migrujem z inej platformy.