Pre vývojárov

Overenéoverené 2026-09-20

V skratke

MitoOps má verejné rozhranie s tromi podobami nad tou istou normalizovanou vrstvou údajov. Líšia sa tým, kto sa pýta a čo smie:

Podoba	Smer	Čo smie
REST API (`/api/v1`)	váš program sa pýta	iba čítanie — odpovedá výhradne na `GET`, žiadna operácia nič nemení
MCP (`/api/mcp`)	AI aplikácia sa pýta	čítanie tých istých údajov a navyše úzke zápisy za citlivými rozsahmi, ktoré človek udelí výslovne: `automations:write` (vypnutý koncept automatizácie a návrh úpravy bežiacej, ktorý publikuje človek), `coupons:write` a `coupons:delete` (zľavový kupón s náhľadom a potvrdením), `affiliate:write` (správa partnerského programu: účet partnera, texty portálu, šablóny, kampane, politika dokumentov), `affiliate:approve` (rozhodnutie o jednej menovanej provízii, výplaty zostávajú v aplikácii), `availabilities:draft` (návrh zmeny číselníka dostupností, ktorý do e-shopu zapíše až človek schválením v aplikácii) a `claims-settings:draft` (návrh zmeny nastavení reklamácií, ktorý zapíše až človek schválením v aplikácii). Ďalej `claims-routes:draft`, `product-content:draft` a `category-content:draft`: návrh spätnej dopravy reklamácií a textov produktov a kategórií, ktorý zapíše človek schválením v aplikácii, alebo hneď, ak klient pre oblasť vedome zapne autonómny zápis. Nič iné cez MCP nevzniká ani sa nemení
Odchádzajúce webhooky	MitoOps posiela vám	podpísaná správa o udalosti (objednávka, úhrada, zásielka, sklad, faktúra, reklamácia) na vašu adresu

Rozhranie dnes vystavuje 125 nástrojov MCP (97 na čítanie, 28 na zápis za citlivými rozsahmi: koncept a revízia automatizácie, zľavové kupóny, správa partnerského programu a návrhy zmien dostupností, nastavení a spätnej dopravy reklamácií a textov produktov a kategórií, ktoré zapíše až človek schválením v aplikácii, ak klient pre oblasť vedome nezapne autonómny zápis), 96 trás REST (všetky iba na čítanie) a 32 rozsahov oprávnení, z toho 13 citlivých, naprieč 19 oblasťami údajov. Čísla vznikajú z katalógu aplikácie pri zostavení tejto stránky, nepíšu sa rukou.

Čo si cez REST a MCP prečítate: e-shopy, objednávky, produkty a kategórie, zásoby s históriou pohybov, faktúry a dobropisy, zásielky a štatistiky doručovania, návštevnosť a kanály, finančné výkazy a predaje, adresár zákazníkov aj zákaznícka analytika v pseudonymoch, dodávatelia, reklamácie so štatistikou, partnerský program, automatizácie, číselník dostupností e-shopov, webhook endpointy a tarifu účtu s limitmi.

REST — iba na čítanie

Adresa je /api/v1 na vašej doméne aplikácie. Volania, parametre, tvar odpovede, obdobie a stránkovanie sú v REST rozhraní. Strojovo čitateľný popis je na /api/v1/openapi.json za tým istým kľúčom; prihlásený človek si ho otvorí aj z obrazovky Nastavenia → API & MCP. Popis vzniká z toho istého zdroja ako rozhranie, takže sa s ním nerozíde.

Čokoľvek iné než GET dostane 405 skôr, než sa server pozrie na kľúč. Nie je to dočasné obmedzenie — REST v1 zapisovacie volania nemá a zápisy MCP sa doň zámerne nedostali. Návrh zmeny dostupností si cez REST iba prečítate (jeho stav), pripraviť ho cez REST nejde.

MCP — čítanie a úzke zápisy

Adresa je /api/mcp. MitoOps je štandardný vzdialený MCP server (Model Context Protocol, otvorený protokol nezávislý od dodávateľa AI); pripojí sa každá aplikácia, ktorá podporuje vzdialené MCP cez HTTP s OAuth alebo s prístupovým kľúčom. Claude.ai je produkčne overený klient; presný postup je v MCP rozhraní.

Nástroje MCP stoja nad tými istými schopnosťami ako REST — nie je to druhé rozhranie s vlastnými dopytmi. Zoznam nástrojov sa riadi rozsahmi kľúča alebo súhlasu: nástroj mimo rozsahu pre aplikáciu neexistuje. Každý nástroj nesie anotácie podľa revízie protokolu 2026-07-28 (readOnlyHint, destructiveHint, idempotentHint), z ktorých AI aplikácia vie, či ide o čítanie alebo o zápis.

OAuth — pripojenie v mene človeka

AI aplikácia, ktorá podporuje vzdialené MCP s OAuth, sa nepripája kľúčom. Zadáte jej adresu /api/mcp, ona vás pošle na prihlásenie do MitoOps (aj s druhým faktorom) a na obrazovke súhlasu vyberiete, čo smie čítať, ktorých e-shopov sa to týka a ktoré zápisy smie (koncepty automatizácií, kupóny, správa partnerského programu, rozhodnutie o provízii, návrhy zmien dostupností). Heslo aplikácia nikdy neuvidí.

Čo sa odovzdáva, rozhoduje prihlásený človek — a nikdy nie viac, než smie sám. Kto nemá právo na nákupné ceny, nemá ho ako odovzdať ďalej; kto nesmie upravovať automatizácie, rozsah automations:write na obrazovke súhlasu vôbec neuvidí. Súhlas OAuth nespotrebúva prístupový kľúč z limitu tarify, ale vyžaduje tarifu s API & MCP — bez nej sa obrazovka súhlasu neotvorí a povie prečo.

Povolenie sa dá kedykoľvek odobrať v Nastavenia → API & MCP a všetky prístupy z neho prestanú platiť v tej istej chvíli.

Prístupový kľúč

Pre server, ktorý volá server, alebo pre váš vlastný program:

V aplikácii otvorte Nastavenia → API & MCP a stlačte Nový kľúč.
Zadajte názov, podľa ktorého kľúč neskôr spoznáte.
Vyberte rozsahy, e-shopy a rozhrania (REST, MCP alebo obe).
Vyberte platnosť a kľúč vytvorte.

Kľúč sa posiela v hlavičke, v adrese sa zámerne neprijíma (adresy sa zapisujú do logov a histórie prehliadača):

Authorization: Bearer <váš kľúč>

Rozsahy oprávnení

Kľúč ani súhlas nikdy nevidí viac, než sa mu pridelilo. Tabuľka vzniká z katalógu aplikácie:

Rozsah	Prístup	Citlivý	Čo otvára
`stores:read`	čítanie	—	zoznam e-shopov s kódom
`orders:read`	čítanie	—	objednávky vrátane položiek; adresa iba krajina a mesto, sumy iba s `reports:read`
`products:read`	čítanie	—	produkty, kategórie a predajnú cenu z karty produktu
`invoices:read`	čítanie	—	faktúry s položkami, dobropisy a zálohovky
`shipping:read`	čítanie	—	zásielky, udalosti sledovania, dopravcovia (bez prístupových údajov) a štatistiky doručovania
`analytics:read`	čítanie	—	návštevnosť, kanály, výsledky vo vyhľadávaní a pokrytie objednávok meraním
`search-console:read`	čítanie	—	výkonnosť vo vyhľadávaní Google zo synchronizovaného archívu: dni, dopyty, stránky, krajiny a zariadenia
`inventory:read`	čítanie	—	stav zásob a históriu skladových pohybov
`reports:read`	čítanie	citlivý	finančný súhrn obdobia (obrat, DPH, náklady, výsledok), predaje po produktoch, výkonnosť po objednávkach, zákazníci ako pseudonymy a sumy v hromadnom výpise objednávok
`purchasing:read`	čítanie	citlivý	dodávatelia, ich ponuky a nákladové zložky
`claims:read`	čítanie	—	reklamácie a vrátenia s väzbami na objednávku, dobropis a spätnú zásielku, časová os a odoslané e-maily prípadu; štatistika a procesy modulu
`automations:read`	čítanie	—	katalóg spúšťačov a akcií, zoznam automatizácií, ich nastavenie, história behov a validácia návrhu
`automations:write`	zápis	citlivý	vytvorenie alebo úprava vypnutého konceptu automatizácie a návrh úpravy zapnutej automatizácie (revízia); zapnúť koncept a zverejniť revíziu môže iba človek v aplikácii, bežiaca automatizácia sa návrhom nemení
`webhooks:read`	čítanie	—	katalóg udalostí, endpointy bez tajomstva a denník doručení bez tela
`account:read`	čítanie	—	tarifu, zapnuté funkcie a limity s aktuálnym využitím
`affiliate:read`	čítanie	—	partnerský program: prehľad, partneri, kampane, zľavové kódy, konverzie, výplaty, štatistika, nastavenie, dokumenty, verejný portál, šablóny e-mailov, články nápovedy a žiadosti o kód; kontakt partnera iba s `personal-data:read`, bankové a daňové údaje nikdy
`affiliate:write`	zápis	citlivý	správa partnerského programu: rozhodnutie o účte partnera (schváliť, zamietnuť, pozastaviť), vybavenie žiadosti o kód, nastavenie programu mimo peňazí, texty portálu, články nápovedy, šablóny e-mailov, kampane a politika dokumentov; rozhodnutie o provízii má vlastný rozsah, výplaty zostávajú v aplikácii
`affiliate:approve`	zápis	citlivý	rozhodnutie o jednej provízii partnerského programu podľa id konverzie: schváliť, zamietnuť alebo zrušiť (zamietnutie a zrušenie s dôvodom, partner dostane e-mail); vyplatená sa nevracia, hromadné schválenie ani výplaty zvonku neexistujú
`customers:read`	čítanie	—	adresár zákazníkov: pseudonym, e-shopy, krajina, jazyk, celoživotné počty a dátumy; meno, firma, e-mail a telefón iba s `personal-data:read`, obrat a LTV iba s `reports:read`
`coupons:read`	čítanie	—	zľavové kupóny e-shopu s výškou zľavy a platnosťou, podporu platformy, aktivačný odkaz a jeho pripravenosť
`coupons:write`	zápis	citlivý	založenie kupónu na vybraných e-shopoch (existujúci s inými parametrami sa neprepíše bez výslovného súhlasu)
`coupons:delete`	zápis	citlivý	nevratné zmazanie kupónu na vybranom e-shope po náhľade a výslovnom potvrdení; kupón so živou závislosťou (AI Mailing, okno registrácie, naplánovaná kampaň, partner) sa nezmaže
`chatbot:read`	čítanie	—	štatistiku webového chatbota za obdobie: zobrazenia a kliky hlášky (miera kliku), otvorenia chatu aj s tým, čím vznikli, počet rozhovorov a správ, výsledky, hodnotenia zákazníkov, lievik registrácie na newsletter a deterministické vyhodnotenie tém rozhovorov (podiely, produkty, kandidáti na medzeru) — iba súčty
`chatbot-conversations:read`	čítanie	citlivý	rozhovory zákazníkov s webovým chatbotom: zoznam s prvou otázkou a prepis so zdrojmi odpovedí bota; zákazník je iba náhodný kľúč rozhovoru, e-mail, telefón a IBAN v texte iba s `personal-data:read`, inak nahradené značkou; iba v rámci retencie e-shopu
`availabilities:draft`	zápis	citlivý	návrh zmeny číselníka dostupností e-shopu (založiť, upraviť, zmazať) s náhľadom; do e-shopu ho zapíše až človek s oprávnením, keď ho schváli v aplikácii, inak po 24 hodinách vyprší; priradenie dostupností k produktom ani stav zásob nemení
`claims-settings:read`	čítanie	—	šablóny e-mailov a protokolov reklamácií, nastavenia modulu, štítky, spätná doprava a formulár na e-shope; bez prístupových tokenov
`claims-settings:draft`	zápis	citlivý	návrh zmeny procesov, stavov, štítkov a textov šablón reklamácií s náhľadom; zapíše ho až človek s oprávnením schválením v aplikácii, inak po 72 hodinách vyprší; nič nemaže
`claims-routes:draft`	zápis	citlivý	návrh založenia, úpravy, zapnutia alebo vypnutia spätnej trasy s rovnakou validáciou ako obrazovka; zapíše ho človek schválením v aplikácii, alebo hneď, ak klient pre oblasť vedome zapol autonómny zápis; trasu nemaže
`product-content:read`	čítanie	—	popis, krátky popis a SEO texty produktu priamo z e-shopu s odtlačkom a zapisovateľnosťou každého poľa
`product-content:draft`	zápis	citlivý	návrh nových textov produktov (najviac 30 naraz), iba obsahové polia, nikdy cena, sklad, kód ani EAN; zapíše ho človek schválením, alebo hneď pri vedome zapnutom autonómnom zápise
`category-content:read`	čítanie	—	horný a dolný popis a SEO texty kategórie s odtlačkom a zapisovateľnosťou podľa platformy e-shopu
`category-content:draft`	zápis	citlivý	návrh nových textov kategórií (najviac 30 naraz), iba polia, ktoré platforma e-shopu vie zapísať; zapíše ho človek schválením, alebo hneď pri vedome zapnutom autonómnom zápise

Citlivé rozsahy nie sú na obrazovke vydania kľúča ani na obrazovke súhlasu predvolené — človek ich musí zaškrtnúť vedome. purchase-prices:read a personal-data:read nemajú vlastný nástroj; rozhodujú o poliach v odpovediach ostatných. Chýbajúce pole nie je nulové — chýba.

Rozsahy sú verejný záväzok: menia sa iba spätne zlučiteľne a kredenciál vydaný skôr nový rozsah nezdedí (rozsahy sú v ňom zapísané menovite). Preto starší kľúč ani starší súhlas nedostal osobné údaje, keď pre ne 2. 9. 2026 vznikol vlastný rozsah, a nedostane ani zápis konceptu — na ten treba nový súhlas alebo nový kľúč.

Nový rozsah sa existujúcemu kľúču dá doplniť aj bez výmeny kľúča: Nastavenia → API & MCP → Upraviť rozsahy. Hodnota kľúča zostáva, integrácia, ktorá ho používa, beží ďalej a nový rozsah má od nasledujúcej požiadavky. Úpravu robí človek s právom spravovať kľúče; tarifa a citlivé rozsahy sa overujú rovnako ako pri vydaní.

Osobné údaje

Rozhranie vydáva prevádzkové údaje, osobné iba s rozsahom personal-data:read:

Objednávky a reklamácie bez neho vracajú iba krajinu a mesto — nie meno, e-mail, telefón ani ulicu.
Adresár zákazníkov (customers:read) vydá sám iba pseudonym, e-shopy, krajinu, jazyk, počty a dátumy. Meno, firmu, e-mail, telefón a marketingové pohlavie pridá až personal-data:read, obrat a LTV až reports:read — chýbajúce pole sa odstráni, nevynuluje.
Zákaznícka analytika (customers/performance) osobné údaje nemá vôbec: zákazník je pseudonym (odtlačok e-mailu), rovnaký ako customerEmailHash na dokladoch a v adresári.
Kontakt dodávateľa a partnera programu ide za tým istým rozsahom.
Rozhovory s webovým chatbotom (chatbot-conversations:read, citlivý) nesú iba náhodný kľúč rozhovoru — bez mena, e-mailu, IP či cookie. E-mail, telefón a IBAN, ktoré zákazník napísal do textu, vydá až personal-data:read; bez neho je na ich mieste značka.
Bankové a daňové údaje partnerov (IBAN, IČO, DIČ, fakturačné údaje výplat), interné poznámky, heslá a tajomstvá druhého faktora sa nevydávajú nikdy — žiadny rozsah ich neotvára.
Webhooky posielajú identifikátory a stavy, nie obsah objednávky ani údaje zákazníka.

Každé volanie sa zapisuje do auditu bez hodnôt vstupu, iba s menami polí a odtlačkom.

Automatizácie: bezpečný zápis konceptu

AI asistent smie automatizáciu navrhnúť, nesmie ju zapnúť. S rozsahom automations:write (citlivý, nikdy predznačený, ponúkne sa iba človeku s právom upravovať automatizácie):

automations_create_draft vytvorí koncept v stave vypnuté — nedotkne sa publikovanej verzie, spúšťačov ani behu;
automations_update_draft upraví iba koncept, ktorý ešte nikto nepublikoval; koncept rozrobený v editore aplikácie sa neprepíše;
koncept sa objaví v Automatizácie ako každý rozrobený návrh a zapnúť, publikovať alebo spustiť ho môže iba človek v aplikácii s právom na schválenie;
automations_revision_create_draft navrhne úpravu publikovanej aj zapnutej automatizácie ako revíziu; bežiaca verzia sa nezmení, kým revíziu človek nenačíta v editore a nepublikuje (automations_revision_update_draft, automations_revision_discard_draft).

Hodnoty polí, ktoré sa v editore vyberajú zo zoznamu (stav objednávky, doprava, platba, stav reklamácie…), vráti automations_options v tvare, ktorý editor ukladá. Hodnota, ktorá v e-shope neexistuje, a zástupný text typu DOPLNIT_… sú chyba validácie, nie úspech.

Vytvorenie je idempotentné cez clientRequestId, úprava vyžaduje expectedVersion a obe vyžadujú catalogVersion z automations_catalog — zastaraný katalóg je konflikt, nie tichý zápis. Návrh, ktorý siaha na neznámy spúšťač, e-shop mimo rozsahu alebo cudzí webhook endpoint, sa neuloží. Podrobne v MCP rozhraní.

Dostupnosti: návrh zmeny, ktorý schvaľuje človek

Dostupnosti sú položky číselníka konkrétneho e-shopu, ktoré e-shop ukazuje pri produkte, napríklad Skladom, Na objednávku alebo Predpredaj: názov, popis, naskladnenie a doručenie v hodinách, význam pre Google Nákupy a farba. Nie je to stav zásob.

availabilities_list a GET /availabilities?market= (rozsah products:read) vrátia číselník jedného e-shopu; market je povinný. Pole manageable hovorí, či sa číselník toho e-shopu dá v MitoOps meniť, a reason prečo nie: PLATFORMA (platforma to nevie), BEZ_ROZSIRENIA (e-shopu WooCommerce chýba doplnok MitoOps) alebo PROSTREDIE (zápis do e-shopov je v prostredí vypnutý).
availabilities_change_draft (iba MCP, citlivý rozsah availabilities:draft) do e-shopu nič nezapíše. Zmenu overí, uloží ako návrh platný 24 hodín a vráti náhľad (pole pred a po, upozornenia, blokovania), draftId a approvalUrl.
Do e-shopu návrh zapíše až človek v aplikácii tlačidlom Schváliť a zapísať v Sklad → Dostupnosti → Správa, alebo ho zamietne. Rozhodujú pritom jeho práva v čase kliknutia, nie rozsah kľúča či súhlasu. Model ani prístupový kľúč bez človeka do e-shopu nezapíše nič.
availabilities_draft_get a GET /availabilities/drafts/:draftId (rozsah products:read) vrátia stav návrhu: pending, writing, executed, partial, failed, rejected alebo expired.

Rozsah availabilities:draft sa ponúkne iba človeku, ktorý by zmenu smel aj schváliť (právo spravovať synchronizáciu skladu a upravovať produkty). Existujúci kľúč ani súhlas ho nezdedí. REST v1 ostáva iba na čítanie. Parametre návrhu sú v MCP rozhraní, obrazovka schválenia v návode Dostupnosti.

Reklamácie: nastavenia na čítanie a návrh zmeny

claims_settings (rozsah claims:read) vráti procesy s ID a názvami typov, krokov a stavov a štítky; s rozsahom claims-settings:read aj nastavenia modulu.
claims_templates a claims_configuration (rozsah claims-settings:read) vrátia šablóny e-mailov a protokolov (predmet, text, kedy a či sa posielajú automaticky) a ostatné nastavenia: štítky, polia, spätnú dopravu a formulár na e-shope, bez tokenu integrácie.
claims_get nesie aj časovú os prípadu, odoslané e-maily a štítky; text správ iba s personal-data:read.
claims_config_change_draft (iba MCP, citlivý rozsah claims-settings:draft) nastavenia nezmení. Uloží návrh zmeny procesov, stavov, štítkov a textov šablón na 72 hodín s náhľadom a approvalUrl; zapíše ho až človek s právom spravovať nastavenia tlačidlom Schváliť a zapísať v Reklamácie → Nastavenia, celý alebo vôbec. Stav vráti claims_config_draft_get.

Parametre sú v MCP rozhraní.

Spätná doprava, texty produktov a autonómny zápis

claims_routes (rozsah claims-settings:read, alebo ktorýkoľvek návrhový rozsah reklamácií) vráti trasy spätnej dopravy, adresy príjemcu, profily dopravcov s ID, príznakom vratky a dosahom a kľúče typov prípadov. claims_routes_change_draft (iba MCP, citlivý rozsah claims-routes:draft) navrhne založenie, úpravu, zapnutie alebo vypnutie trasy. Server ju overí rovnako ako obrazovka: profil s povolenou vratkou, dosah dopravcu, existujúca adresa a typy, nezáporná cena a žiadny konflikt so zapnutou trasou. Mazanie trasy cez MCP nie je.
products_content_get a GET /products/:code/content?market= (rozsah product-content:read) vrátia popis, krátky popis a SEO texty produktu priamo z e-shopu, každé pole s odtlačkom (hash) a s tým, či ho platforma vie zapísať. categories_content_get a GET /categories/:guid/content?market= (rozsah category-content:read) vrátia to isté pre kategóriu.
products_content_change_draft a categories_content_change_draft (iba MCP, citlivé rozsahy product-content:draft a category-content:draft) navrhnú nové texty, najviac 30 položiek naraz. Prijmú iba obsahové polia; cenu, sklad, dostupnosť, kód, EAN ani názov takto nezmeníte. HTML sa overí: žiadny skript okrem jedného bloku JSON-LD FAQPage, žiadne on…, javascript: ani iframe. Pri schválení sa text porovná so stavom e-shopu a keď ho niekto medzitým zmenil, nezapíše sa nič (CHANGED_SINCE_DRAFT). Keď e-shop text pri ukladaní upraví, výsledok to povie (MODIFIED_BY_PLATFORM). Návrhy sa schvaľujú v Sklad → Zmeny produktov. Na WooCommerce sa návrh so skriptom (aj JSON-LD) alebo so spätnou lomkou zablokuje (PLATFORM_STRIPS_SCRIPT, PLATFORM_STRIPS_BACKSLASH): WordPress ich pri uložení odstráni a zvyšok by zákazníci videli ako text.
products_content_policy a GET /product-content/policy?market= (rozsah product-content:read) povedia bez volania e-shopu, čo smie váš kľúč na danom e-shope s textami robiť: či smie čítať (readEnabled) a navrhovať (draftEnabled, návrh iba cez MCP), ktoré polia platforma zapíše (supportedFields; SEO polia na WooCommerce iba so SEO doplnkom), režim schvaľovania (approvalMode: human, autonomous alebo disabled) a či sa návrh zapíše sám (autonomousWriteEnabled), limity návrhu a algoritmus odtlačkov (sha256). Pozastavený e-shop, nepodporovaná platforma alebo kľúč e-shopu iba na čítanie sú status a reason v odpovedi, nie chyba. Pole category nesie to isté pre kategórie. Pole structuredData povie, či platforma zachová štruktúrované dáta v popise produktu: na WooCommerce nie (NOT_SUPPORTED, PLATFORM_STRIPS_SCRIPT; štruktúrované dáta tam spravuje téma e-shopu, THEME_MANAGED), na Shoptete áno (jeden blok FAQPage).
Autonómny zápis. Predvolene každý návrh (nastavenia a trasy reklamácií, texty produktov a kategórií) zapíše až človek schválením. Správca ho môže pre jednotlivú oblasť zapnúť v Nastavenia → API & MCP → Zápis cez AI. Návrh sa potom zapíše hneď, tou istou cestou ako schválenie, v mene človeka, ktorý AI prístup udelil, a iba ak ten človek práve teraz má právo zmenu schváliť. Inak návrh čaká a odpoveď povie prečo. Každá zmena režimu sa zaznamená.

Existujúci kľúč ani súhlas nové rozsahy nezdedí; treba nový súhlas.

Odchádzajúce webhooky

REST a MCP sú čítanie na požiadanie. Keď sa má váš systém o udalosti dozvedieť hneď — nová objednávka, úhrada, zmena stavu, zásielka, doručenie, pohyb zásoby, faktúra, reklamácia — odoberá ju cez odchádzajúce webhooky: MitoOps pošle na vašu adresu krátku obálku s identifikátormi, podpísanú HMAC-SHA256, s opakovaním pri zlyhaní a denníkom pokusov. Detail si systém potom načíta cez REST.

Odbery zakladá človek v aplikácii na tej istej obrazovke ako kľúče; cez REST a MCP sa endpointy iba čítajú (webhooks:read, bez tajomstva). Endpoint sa dá použiť aj ako krok automatizácie. Podrobne v odchádzajúcich webhookoch.

Limity účtu

API & MCP a webhooky sú súčasťou každej platenej tarify od Start vyššie. Tarify sa líšia počtom aktívnych kľúčov a endpointov, nie tým, čo sa dá prečítať:

Tarifa	API & MCP	Aktívne prístupové kľúče	Webhook endpointy
Skúšobná verzia	—	0	0
Začiatočník	—	0	0
Start	áno	1	5
Rast	áno	2	20
Pro	áno	5	50
Na mieru	áno	podľa dohody	podľa dohody

Limity vymáha server: pokus o ďalší kľúč alebo endpoint nad limit skončí odmietnutím s vysvetlením. Výmena kľúča ani rotácia tajomstva endpointu miesto nespotrebuje. Zníženie tarify existujúce kľúče ani endpointy nezruší — prestane sa dať vytvoriť nový, kým počet neklesne pod nový strop. Pripojenie cez OAuth kľúč nespotrebúva.

Aktuálne hodnoty pre váš účet vrátane využitia (aktívne automatizácie, behy za mesiac, e-maily, kredity) vydá account_entitlements / GET /account/entitlements s rozsahom account:read. Nesie iba tarifu, funkcie a limity — bez fakturačných údajov. Aktuálny cenník je na mitoops.com/cennik.

Stropy volaní

Strop	Na čom sa meria	Koľko
pred overením	na adresu, z ktorej voláte	300 volaní / 60 s
po overení	na konkrétny kľúč	600 volaní / 60 s

Prvý bráni hádaniu kľúčov, druhý je váš a nezdieľate ho s nikým. Prekročenie je 429 s hlavičkami RateLimit-*. Nie je to tarifná veličina — za počet volaní sa neúčtuje.

Chyby

Odpoveď pri chybe má vždy rovnaký tvar a nesie kód:

{ "error": { "code": "store_required", "message": "…", "requestId": "…" } }

Stav	Kód	Kedy
`400`	`invalid_request`	parameter nezodpovedá popisu (zlý dátum, obrátené obdobie, neplatný kurzor)
`400`	`store_required`	volanie nad údajmi e-shopu bez `market`
`401`	`unauthorized`	chýbajúci, neznámy, zrušený alebo neplatný kľúč
`403`	`forbidden`	kľúč nemá potrebný rozsah
`403`	`store_forbidden`	e-shop mimo rozsahu kľúča
`404`	`not_found`	záznam neexistuje (aj vtedy, keď patrí inému e-shopu)
`405`	—	čokoľvek iné než `GET` (REST)
`409`	`conflict`	zápis konceptu narazil na inú verziu, použitý `clientRequestId` alebo zmenený katalóg (MCP)
`429`	`rate_limited`	prekročený technický strop volaní

Dôvod odmietnutia pri 401 sa nerozlišuje — rozdiel by pomohol tomu, kto kľúče háda. requestId uveďte, keď hlásite problém podpore. Cez MCP prichádza chyba, ktorú vie asistent opraviť, ako výsledok nástroja s príznakom isError; chyba protokolu ako chyba JSON-RPC.

Príklady

# Objednávky za obdobie, po stranách
curl -H "Authorization: Bearer <váš kľúč>" \
  "https://<vaša adresa>/api/v1/orders?market=sk&from=2026-08-01&to=2026-08-31&limit=50"

# Štatistiky doručovania za august
curl -H "Authorization: Bearer <váš kľúč>" \
  "https://<vaša adresa>/api/v1/shipping/stats?market=sk&from=2026-08-01&to=2026-08-31"

# Štatistika reklamácií za august
curl -H "Authorization: Bearer <váš kľúč>" \
  "https://<vaša adresa>/api/v1/claims/statistics?market=sk&from=2026-08-01&to=2026-08-31"

# Tarifa a limity účtu s využitím
curl -H "Authorization: Bearer <váš kľúč>" \
  "https://<vaša adresa>/api/v1/account/entitlements"

Otázky, na ktoré po pripojení odpovie Claude.ai z údajov MitoOps: „Aký bol medián času doručenia DHL a GLS za august?“, „Koľko objednávok prišlo z ChatGPT?“, „Aká je marža produktu X za posledný mesiac?“ (s purchase-prices:read), „Koľko reklamácií je po termíne?“, „Navrhni automatizáciu, ktorá pri neuhradenej objednávke po troch dňoch pošle upozornenie“ (s automations:write — vznikne vypnutý koncept), „Premenuj na e-shope SK dostupnosť Na objednávku na Do 5 dní“ (s availabilities:draft vznikne návrh, ktorý zapíšete schválením v aplikácii).

Bezpečnosť

Izolácia zákazníckych priestorov. Klient pochádza výhradne z kredenciálu; každý klient má vlastnú databázu.
Rozsah e-shopov je prienik zoznamu z kredenciálu a e-shopov, ktoré máte pripojené v tej chvíli. Pri volaniach nad údajmi jedného e-shopu je market povinný — chýbajúci e-shop je 400, e-shop mimo rozsahu 403.
Práva človeka. Obrazovka súhlasu ponúka iba rozsahy, ktoré má prihlásený človek sám; vlastná sada oprávnení účtu rozhoduje.
Hranice zápisov vynucuje služba, nie anotácia: koncept automatizácie vzniká vždy vypnutý, publikovaná automatizácia sa cez MCP nezmení a návrh zmeny dostupností do e-shopu nezapíše nič, kým ho človek neschváli v aplikácii.
Platnosť a odvolanie. Prístupový token OAuth platí hodinu, obnovovací 30 dní; odvolaný súhlas zastaví každý token, ktorý z neho vznikol. Kľúče sa dajú okamžite zrušiť alebo vymeniť.
Audit. Každé volanie je zapísané s menom schopnosti, rozhraním a odtlačkom vstupu — bez hodnôt.
Na čo sa spoľahnúť nedá: neverejné adresy aplikácie (rozhranie je /api/v1 a /api/mcp, nič iné), priamy prístup do databázy (neexistuje) a prístupové údaje (rozhranie ich nevydáva).