Pro vývojáře

Ověřenoověřeno 2026-09-20

Stručně

MitoOps má veřejné rozhraní se třemi podobami nad toutéž normalizovanou vrstvou údajů. Liší se tím, kdo se ptá a co smí:

Podoba	Směr	Co smí
REST API (`/api/v1`)	váš program se ptá	pouze čtení — odpovídá výhradně na `GET`, žádná operace nic nemění
MCP (`/api/mcp`)	AI aplikace se ptá	čtení týchž údajů a navíc úzké zápisy za citlivými rozsahy, které člověk udělí výslovně: `automations:write` (vypnutý koncept automatizace a návrh úpravy běžící, který zveřejní člověk), `coupons:write` a `coupons:delete` (slevový kupon s náhledem a potvrzením), `affiliate:write` (správa partnerského programu: účet partnera, texty portálu, šablony, kampaně, politika dokumentů), `affiliate:approve` (rozhodnutí o jedné jmenované provizi, výplaty zůstávají v aplikaci), `availabilities:draft` (návrh změny číselníku dostupností, který do e-shopu zapíše až člověk schválením v aplikaci) a `claims-settings:draft` (návrh změny nastavení reklamací, který zapíše až člověk schválením v aplikaci). Dále `claims-routes:draft`, `product-content:draft` a `category-content:draft`: návrh zpětné dopravy reklamací a textů produktů a kategorií, který zapíše člověk schválením v aplikaci, nebo hned, pokud klient pro oblast vědomě zapne autonomní zápis. Nic jiného přes MCP nevzniká ani se nemění
Odchozí webhooky	MitoOps posílá vám	podepsaná zpráva o události (objednávka, úhrada, zásilka, sklad, faktura, reklamace) na vaši adresu

Rozhraní dnes vystavuje 130 nástrojů MCP (102 pro čtení, 28 pro zápis za citlivými rozsahy: koncept a revize automatizace, slevové kupony, správa partnerského programu a návrhy změn dostupností, nastavení a zpětné dopravy reklamací a textů produktů a kategorií, které zapíše až člověk schválením v aplikaci, pokud klient pro oblast vědomě nezapne autonomní zápis), 101 cest REST (všechny pouze pro čtení) a 32 rozsahů oprávnění, z toho 13 citlivých, napříč 19 oblastmi údajů. Čísla vznikají z katalogu aplikace při sestavení této stránky, nepíší se ručně.

Co si přes REST a MCP přečtete: e-shopy, objednávky, produkty a kategorie, zásoby s historií pohybů, faktury a dobropisy, zásilky a statistiky doručování, návštěvnost a kanály, finanční výkazy a prodeje, adresář zákazníků i zákaznická analytika v pseudonymech, dodavatelé, reklamace se statistikou, partnerský program, automatizace, číselník dostupností e-shopů, webhook endpointy a tarif účtu s limity.

REST — pouze pro čtení

Adresa je /api/v1 na vaší doméně aplikace. Volání, parametry, tvar odpovědi, období a stránkování jsou v REST rozhraní. Strojově čitelný popis je na /api/v1/openapi.json za týmž klíčem; přihlášený člověk si ho otevře i z obrazovky Nastavení → API & MCP. Popis vzniká z téhož zdroje jako rozhraní, takže se s ním nerozejde.

Cokoli jiného než GET dostane 405 dřív, než se server podívá na klíč. Není to dočasné omezení — REST v1 zapisovací volání nemá a zápisy MCP se do něj záměrně nedostaly. Návrh změny dostupností si přes REST jen přečtete (jeho stav), připravit ho přes REST nejde.

MCP — čtení a úzké zápisy

Adresa je /api/mcp. MitoOps je standardní vzdálený MCP server (Model Context Protocol, otevřený protokol nezávislý na dodavateli AI); připojí se každá aplikace, která podporuje vzdálené MCP přes HTTP s OAuth nebo s přístupovým klíčem. Claude.ai je produkčně ověřený klient; přesný postup je v MCP rozhraní.

Nástroje MCP stojí nad týmiž schopnostmi jako REST — není to druhé rozhraní s vlastními dotazy. Seznam nástrojů se řídí rozsahy klíče nebo souhlasu: nástroj mimo rozsah pro aplikaci neexistuje. Každý nástroj nese anotace podle revize protokolu 2026-07-28 (readOnlyHint, destructiveHint, idempotentHint), z nichž AI aplikace ví, zda jde o čtení nebo o zápis.

OAuth — připojení jménem člověka

AI aplikace, která podporuje vzdálené MCP s OAuth, se nepřipojuje klíčem. Zadáte jí adresu /api/mcp, ona vás pošle na přihlášení do MitoOps (i s druhým faktorem) a na obrazovce souhlasu vyberete, co smí číst, kterých e-shopů se to týká a které zápisy smí (koncepty automatizací, kupony, správa partnerského programu, rozhodnutí o provizi, návrhy změn dostupností). Heslo aplikace nikdy neuvidí.

Co se předává, rozhoduje přihlášený člověk — a nikdy ne víc, než smí sám. Kdo nemá právo na nákupní ceny, nemá ho jak předat dál; kdo nesmí upravovat automatizace, rozsah automations:write na obrazovce souhlasu vůbec neuvidí. Souhlas OAuth nespotřebovává přístupový klíč z limitu tarifu, ale vyžaduje tarif s API & MCP — bez něj se obrazovka souhlasu neotevře a řekne proč.

Povolení lze kdykoli odebrat v Nastavení → API & MCP a všechny přístupy z něj přestanou platit v téže chvíli.

Přístupový klíč

Pro server, který volá server, nebo pro váš vlastní program:

V aplikaci otevřete Nastavení → API & MCP a stiskněte Nový klíč.
Zadejte název, podle kterého klíč později poznáte.
Vyberte rozsahy, e-shopy a rozhraní (REST, MCP nebo obojí).
Vyberte platnost a klíč vytvořte.

Klíč se posílá v hlavičce, v adrese se záměrně nepřijímá (adresy se zapisují do logů a historie prohlížeče):

Authorization: Bearer <váš klíč>

Rozsahy oprávnění

Klíč ani souhlas nikdy nevidí víc, než mu bylo přiděleno. Tabulka vzniká z katalogu aplikace:

Rozsah	Přístup	Citlivý	Co otevírá
`stores:read`	čtení	—	seznam e-shopů s kódem
`orders:read`	čtení	—	objednávky včetně položek; adresa jen země a město, částky jen s `reports:read`
`products:read`	čtení	—	produkty, kategorie a prodejní cenu z karty produktu
`invoices:read`	čtení	—	faktury s položkami, dobropisy a zálohové faktury
`shipping:read`	čtení	—	zásilky, události sledování, dopravci (bez přístupových údajů) a statistiky doručování
`analytics:read`	čtení	—	návštěvnost, kanály, výsledky ve vyhledávání a pokrytí objednávek měřením
`search-console:read`	čtení	—	výkon ve vyhledávání Google ze synchronizovaného archivu: dny, dotazy, stránky, země a zařízení
`inventory:read`	čtení	—	stav zásob a historii skladových pohybů
`reports:read`	čtení	citlivý	finanční souhrn období (obrat, DPH, náklady, výsledek), obraty se srovnáním a po měsících, reklama (výdaje, rozpočet, ROAS, PNO, CPA, MER), kdy přicházejí objednávky, zdroje tržeb, prodeje po produktech, výkonnost po objednávkách, zákazníci jako pseudonymy a částky v hromadném výpisu objednávek
`purchasing:read`	čtení	citlivý	dodavatelé, jejich nabídky a nákladové složky
`claims:read`	čtení	—	reklamace a vrácení s vazbami na objednávku, dobropis a zpětnou zásilku, časová osa a odeslané e-maily případu; statistika a procesy modulu
`automations:read`	čtení	—	katalog spouštěčů a akcí, seznam automatizací, jejich nastavení, historie běhů a validace návrhu
`automations:write`	zápis	citlivý	vytvoření nebo úprava vypnutého konceptu automatizace a návrh úpravy zapnuté automatizace (revize); zapnout koncept a zveřejnit revizi může pouze člověk v aplikaci, běžící automatizace se návrhem nemění
`webhooks:read`	čtení	—	katalog událostí, endpointy bez tajemství a deník doručení bez těla
`account:read`	čtení	—	tarif, zapnuté funkce a limity s aktuálním využitím
`affiliate:read`	čtení	—	partnerský program: přehled, partneři, kampaně, slevové kódy, konverze, výplaty, statistika, nastavení, dokumenty, veřejný portál, šablony e-mailů, články nápovědy a žádosti o kód; kontakt partnera jen s `personal-data:read`, bankovní a daňové údaje nikdy
`affiliate:write`	zápis	citlivý	správa partnerského programu: rozhodnutí o účtu partnera (schválit, zamítnout, pozastavit), vyřízení žádosti o kód, nastavení programu mimo peněz, texty portálu, články nápovědy, šablony e-mailů, kampaně a politika dokumentů; rozhodnutí o provizi má vlastní rozsah, výplaty zůstávají v aplikaci
`affiliate:approve`	zápis	citlivý	rozhodnutí o jedné provizi partnerského programu podle id konverze: schválit, zamítnout nebo zrušit (zamítnutí a zrušení s důvodem, partner dostane e-mail); vyplacená se nevrací, hromadné schválení ani výplaty zvenku neexistují
`customers:read`	čtení	—	adresář zákazníků: pseudonym, e-shopy, země, jazyk, celoživotní počty a data; jméno, firma, e-mail a telefon jen s `personal-data:read`, obrat a LTV jen s `reports:read`
`coupons:read`	čtení	—	slevové kupóny e-shopu s výší slevy a platností, podporu platformy, aktivační odkaz a jeho připravenost
`coupons:write`	zápis	citlivý	založení kupónu na vybraných e-shopech (existující s jinými parametry se nepřepíše bez výslovného souhlasu)
`coupons:delete`	zápis	citlivý	nevratné smazání kupónu na vybraném e-shopu po náhledu a výslovném potvrzení; kupón se živou závislostí (AI Mailing, okno registrace, naplánovaná kampaň, partner) se nesmaže
`chatbot:read`	čtení	—	statistiku webového chatbota za období: zobrazení a kliky hlášky (míra kliku), otevření chatu i s tím, čím vznikla, počet rozhovorů a zpráv, výsledky, hodnocení zákazníků, trychtýř registrace na newsletter a deterministické vyhodnocení témat rozhovorů (podíly, produkty, kandidáti na mezeru) — pouze součty
`chatbot-conversations:read`	čtení	citlivý	rozhovory zákazníků s webovým chatbotem: seznam s první otázkou a přepis se zdroji odpovědí bota; zákazník je jen náhodný klíč rozhovoru, e-mail, telefon a IBAN v textu jen s `personal-data:read`, jinak nahrazené značkou; jen v rámci retence e-shopu
`availabilities:draft`	zápis	citlivý	návrh změny číselníku dostupností e-shopu (založit, upravit, smazat) s náhledem; do e-shopu ho zapíše až člověk s oprávněním, když ho schválí v aplikaci, jinak po 24 hodinách vyprší; přiřazení dostupností k produktům ani stav zásob nemění
`claims-settings:read`	čtení	—	šablony e-mailů a protokolů reklamací, nastavení modulu, štítky, zpětná doprava a formulář na e-shopu; bez přístupových tokenů
`claims-settings:draft`	zápis	citlivý	návrh změny procesů, stavů, štítků a textů šablon reklamací s náhledem; zapíše ho až člověk s oprávněním schválením v aplikaci, jinak po 72 hodinách vyprší; nic nemaže
`claims-routes:draft`	zápis	citlivý	návrh založení, úpravy, zapnutí nebo vypnutí zpětné trasy se stejnou validací jako obrazovka; zapíše ho člověk schválením v aplikaci, nebo hned, pokud klient pro oblast vědomě zapnul autonomní zápis; trasu nemaže
`product-content:read`	čtení	—	popis, krátký popis a SEO texty produktu přímo z e-shopu s otiskem a zapisovatelností každého pole
`product-content:draft`	zápis	citlivý	návrh nových textů produktů (nejvýše 30 najednou), jen obsahová pole, nikdy cena, sklad, kód ani EAN; zapíše ho člověk schválením, nebo hned při vědomě zapnutém autonomním zápisu
`category-content:read`	čtení	—	horní a dolní popis a SEO texty kategorie s otiskem a zapisovatelností podle platformy e-shopu
`category-content:draft`	zápis	citlivý	návrh nových textů kategorií (nejvýše 30 najednou), jen pole, která platforma e-shopu umí zapsat; zapíše ho člověk schválením, nebo hned při vědomě zapnutém autonomním zápisu

Citlivé rozsahy nejsou na obrazovce vydání klíče ani na obrazovce souhlasu předvyplněné — člověk je musí zaškrtnout vědomě. purchase-prices:read a personal-data:read nemají vlastní nástroj; rozhodují o polích v odpovědích ostatních. Chybějící pole není nulové — chybí.

Rozsahy jsou veřejný závazek: mění se jen zpětně slučitelně a kredenciál vydaný dříve nový rozsah nezdědí (rozsahy jsou v něm zapsané jmenovitě). Proto starší klíč ani starší souhlas nedostal osobní údaje, když pro ně 2. 9. 2026 vznikl vlastní rozsah, a nedostane ani zápis konceptu — na ten je potřeba nový souhlas nebo nový klíč.

Nový rozsah lze existujícímu klíči doplnit i bez výměny klíče: Nastavení → API & MCP → Upravit rozsahy. Hodnota klíče zůstává, integrace, která ho používá, běží dál a nový rozsah má od následujícího požadavku. Úpravu provádí člověk s právem spravovat klíče; tarif a citlivé rozsahy se ověřují stejně jako při vydání.

Osobní údaje

Rozhraní vydává provozní údaje, osobní jen s rozsahem personal-data:read:

Objednávky a reklamace bez něj vracejí jen zemi a město — ne jméno, e-mail, telefon ani ulici.
Adresář zákazníků (customers:read) vydá sám jen pseudonym, e-shopy, zemi, jazyk, počty a data. Jméno, firmu, e-mail, telefon a marketingové pohlaví přidá až personal-data:read, obrat a LTV až reports:read — chybějící pole se odstraní, nevynuluje.
Zákaznická analytika (customers/performance) osobní údaje nemá vůbec: zákazník je pseudonym (otisk e-mailu), stejný jako customerEmailHash na dokladech i v adresáři.
Kontakt dodavatele a partnera programu jde za týmž rozsahem.
Rozhovory s webovým chatbotem (chatbot-conversations:read, citlivý) nesou jen náhodný klíč rozhovoru — bez jména, e-mailu, IP či cookie. E-mail, telefon a IBAN, které zákazník napsal do textu, vydá až personal-data:read; bez něj je na jejich místě značka.
Bankovní a daňové údaje partnerů (IBAN, IČO, DIČ, fakturační údaje výplat), interní poznámky, hesla a tajemství druhého faktoru se nevydávají nikdy — žádný rozsah je neotevírá.
Webhooky posílají identifikátory a stavy, ne obsah objednávky ani údaje zákazníka.

Každé volání se zapisuje do auditu bez hodnot vstupu, jen se jmény polí a otiskem.

Automatizace: bezpečný zápis konceptu

AI asistent smí automatizaci navrhnout, nesmí ji zapnout. S rozsahem automations:write (citlivý, nikdy předvyplněný, nabídne se jen člověku s právem upravovat automatizace):

automations_create_draft vytvoří koncept ve stavu vypnuto — nedotkne se publikované verze, spouštěčů ani běhu;
automations_update_draft upraví jen koncept, který ještě nikdo nepublikoval; koncept rozpracovaný v editoru aplikace se nepřepíše;
koncept se objeví v Automatizacích jako každý rozpracovaný návrh a zapnout, publikovat nebo spustit ho může jen člověk v aplikaci s právem na schválení;
automations_revision_create_draft navrhne úpravu publikované i zapnuté automatizace jako revizi; běžící verze se nezmění, dokud revizi člověk nenačte v editoru a nezveřejní (automations_revision_update_draft, automations_revision_discard_draft).

Hodnoty polí, která se v editoru vybírají ze seznamu (stav objednávky, doprava, platba, stav reklamace…), vrátí automations_options v tvaru, který editor ukládá. Hodnota, která v e-shopu neexistuje, a zástupný text typu DOPLNIT_… jsou chyba validace, ne úspěch.

Vytvoření je idempotentní přes clientRequestId, úprava vyžaduje expectedVersion a obě vyžadují catalogVersion z automations_catalog — zastaralý katalog je konflikt, ne tichý zápis. Návrh, který sahá na neznámý spouštěč, e-shop mimo rozsah nebo cizí webhook endpoint, se neuloží. Podrobně v MCP rozhraní.

Dostupnosti: návrh změny, který schvaluje člověk

Dostupnosti jsou položky číselníku konkrétního e-shopu, které e-shop ukazuje u produktu, například Skladem, Na objednávku nebo Předprodej: název, popis, naskladnění a doručení v hodinách, význam pro Google Nákupy a barva. Není to stav zásob.

availabilities_list a GET /availabilities?market= (rozsah products:read) vrátí číselník jednoho e-shopu; market je povinný. Pole manageable říká, zda se číselník toho e-shopu dá v MitoOps měnit, a reason proč ne: PLATFORMA (platforma to neumí), BEZ_ROZSIRENIA (e-shopu WooCommerce chybí doplněk MitoOps) nebo PROSTREDIE (zápis do e-shopů je v prostředí vypnutý).
availabilities_change_draft (jen MCP, citlivý rozsah availabilities:draft) do e-shopu nic nezapíše. Změnu ověří, uloží jako návrh platný 24 hodin a vrátí náhled (pole před a po, upozornění, blokace), draftId a approvalUrl.
Do e-shopu návrh zapíše až člověk v aplikaci tlačítkem Schválit a zapsat v Sklad → Dostupnosti → Správa, nebo ho zamítne. Rozhodují přitom jeho práva v okamžiku kliknutí, ne rozsah klíče či souhlasu. Model ani přístupový klíč bez člověka do e-shopu nezapíše nic.
availabilities_draft_get a GET /availabilities/drafts/:draftId (rozsah products:read) vrátí stav návrhu: pending, writing, executed, partial, failed, rejected nebo expired.

Rozsah availabilities:draft se nabídne jen člověku, který by změnu směl i schválit (právo spravovat synchronizaci skladu a upravovat produkty). Existující klíč ani souhlas ho nezdědí. REST v1 zůstává jen ke čtení. Parametry návrhu jsou v MCP rozhraní, obrazovka schválení v návodu Dostupnosti.

Reklamace: nastavení ke čtení a návrh změny

claims_settings (rozsah claims:read) vrátí procesy s ID a názvy typů, kroků a stavů a štítky; s rozsahem claims-settings:read i nastavení modulu.
claims_templates a claims_configuration (rozsah claims-settings:read) vrátí šablony e-mailů a protokolů (předmět, text, kdy a zda se posílají automaticky) a ostatní nastavení: štítky, pole, zpětnou dopravu a formulář na e-shopu, bez tokenu integrace.
claims_get nese i časovou osu případu, odeslané e-maily a štítky; text zpráv jen s personal-data:read.
claims_config_change_draft (jen MCP, citlivý rozsah claims-settings:draft) nastavení nezmění. Uloží návrh změny procesů, stavů, štítků a textů šablon na 72 hodin s náhledem a approvalUrl; zapíše ho až člověk s právem spravovat nastavení tlačítkem Schválit a zapsat v Reklamace → Nastavení, celý nebo vůbec. Stav vrátí claims_config_draft_get.

Parametry jsou v MCP rozhraní.

Zpětná doprava, texty produktů a autonomní zápis

claims_routes (rozsah claims-settings:read, nebo kterýkoli návrhový rozsah reklamací) vrátí trasy zpětné dopravy, adresy příjemce, profily dopravců s ID, příznakem vratky a dosahem a klíče typů případů. claims_routes_change_draft (jen MCP, citlivý rozsah claims-routes:draft) navrhne založení, úpravu, zapnutí nebo vypnutí trasy. Server ji ověří stejně jako obrazovka: profil s povolenou vratkou, dosah dopravce, existující adresa a typy, nezáporná cena a žádný konflikt se zapnutou trasou. Mazání trasy přes MCP není.
products_content_get a GET /products/:code/content?market= (rozsah product-content:read) vrátí popis, krátký popis a SEO texty produktu přímo z e-shopu, každé pole s otiskem (hash) a s tím, zda ho platforma umí zapsat. categories_content_get a GET /categories/:guid/content?market= (rozsah category-content:read) vrátí totéž pro kategorii.
products_content_change_draft a categories_content_change_draft (jen MCP, citlivé rozsahy product-content:draft a category-content:draft) navrhnou nové texty, nejvýše 30 položek najednou. Přijmou jen obsahová pole; cenu, sklad, dostupnost, kód, EAN ani název takto nezměníte. HTML se ověří: žádný skript kromě jednoho bloku JSON-LD FAQPage, žádné on…, javascript: ani iframe. Při schválení se text porovná se stavem e-shopu, a když ho někdo mezitím změnil, nezapíše se nic (CHANGED_SINCE_DRAFT). Když e-shop text při ukládání upraví, výsledek to řekne (MODIFIED_BY_PLATFORM). Návrhy se schvalují v Sklad → Změny produktů. Na WooCommerce se návrh se skriptem (i JSON-LD) nebo se zpětným lomítkem zablokuje (PLATFORM_STRIPS_SCRIPT, PLATFORM_STRIPS_BACKSLASH): WordPress je při uložení odstraní a zbytek by zákazníci viděli jako text.
products_content_policy a GET /product-content/policy?market= (rozsah product-content:read) řeknou bez volání e-shopu, co smí váš klíč na daném e-shopu s texty dělat: zda smí číst (readEnabled) a navrhovat (draftEnabled, návrh jen přes MCP), která pole platforma zapíše (supportedFields; SEO pole na WooCommerce jen se SEO doplňkem), režim schvalování (approvalMode: human, autonomous nebo disabled) a zda se návrh zapíše sám (autonomousWriteEnabled), limity návrhu a algoritmus otisků (sha256). Pozastavený e-shop, nepodporovaná platforma nebo klíč e-shopu jen pro čtení jsou status a reason v odpovědi, ne chyba. Pole category nese totéž pro kategorie. Pole structuredData řekne, zda platforma zachová strukturovaná data v popisu produktu: na WooCommerce ne (NOT_SUPPORTED, PLATFORM_STRIPS_SCRIPT; strukturovaná data tam spravuje šablona e-shopu, THEME_MANAGED), na Shoptetu ano (jeden blok FAQPage).
Autonomní zápis. Ve výchozím stavu každý návrh (nastavení a trasy reklamací, texty produktů a kategorií) zapíše až člověk schválením. Správce ho může pro jednotlivou oblast zapnout v Nastavení → API & MCP → Zápis přes AI. Návrh se pak zapíše hned, stejnou cestou jako schválení, jménem člověka, který AI přístup udělil, a jen pokud ten člověk právě teď má právo změnu schválit. Jinak návrh čeká a odpověď řekne proč. Každá změna režimu se zaznamená.

Existující klíč ani souhlas nové rozsahy nezdědí; je potřeba nový souhlas.

Odchozí webhooky

REST a MCP jsou čtení na vyžádání. Když se má váš systém o události dozvědět hned — nová objednávka, úhrada, změna stavu, zásilka, doručení, pohyb zásoby, faktura, reklamace — odebírá ji přes odchozí webhooky: MitoOps pošle na vaši adresu krátkou obálku s identifikátory, podepsanou HMAC-SHA256, s opakováním při selhání a deníkem pokusů. Detail si systém potom načte přes REST.

Odběry zakládá člověk v aplikaci na téže obrazovce jako klíče; přes REST a MCP se endpointy jen čtou (webhooks:read, bez tajemství). Endpoint lze použít i jako krok automatizace. Podrobně v odchozích webhoocích.

Limity účtu

API & MCP a webhooky jsou součástí každého placeného tarifu od Startu výš. Tarify se liší počtem aktivních klíčů a endpointů, ne tím, co lze přečíst:

Tarif	API & MCP	Aktivní přístupové klíče	Webhook endpointy
Zkušební verze	—	0	0
Začátečník	—	0	0
Start	ano	1	5
Růst	ano	2	20
Pro	ano	5	50
Na míru	ano	podle dohody	podle dohody

Limity vymáhá server: pokus o další klíč nebo endpoint nad limit skončí odmítnutím s vysvětlením. Výměna klíče ani rotace tajemství endpointu místo nespotřebuje. Snížení tarifu existující klíče ani endpointy nezruší — přestane jít vytvořit nový, dokud počet neklesne pod nový strop. Připojení přes OAuth klíč nespotřebovává.

Aktuální hodnoty pro váš účet včetně využití (aktivní automatizace, běhy za měsíc, e-maily, kredity) vydá account_entitlements / GET /account/entitlements s rozsahem account:read. Nese jen tarif, funkce a limity — bez fakturačních údajů. Aktuální ceník je na mitoops.com/cs/cennik.

Stropy volání

Strop	Na čem se měří	Kolik
před ověřením	na adresu, ze které voláte	300 volání / 60 s
po ověření	na konkrétní klíč	600 volání / 60 s

První brání hádání klíčů, druhý je váš a nesdílíte ho s nikým. Překročení je 429 s hlavičkami RateLimit-*. Není to tarifní veličina — za počet volání se neúčtuje.

Chyby

Odpověď při chybě má vždy stejný tvar a nese kód:

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

Stav	Kód	Kdy
`400`	`invalid_request`	parametr neodpovídá popisu (špatné datum, obrácené období, neplatný kurzor)
`400`	`store_required`	volání nad údaji e-shopu bez `market`
`401`	`unauthorized`	chybějící, neznámý, zrušený nebo neplatný klíč
`403`	`forbidden`	klíč nemá potřebný rozsah
`403`	`store_forbidden`	e-shop mimo rozsah klíče
`404`	`not_found`	záznam neexistuje (i když patří jinému e-shopu)
`405`	—	cokoli jiného než `GET` (REST)
`409`	`conflict`	zápis konceptu narazil na jinou verzi, použitý `clientRequestId` nebo změněný katalog (MCP)
`429`	`rate_limited`	překročený technický strop volání

Důvod odmítnutí při 401 se nerozlišuje — rozdíl by pomohl tomu, kdo klíče hádá. requestId uveďte, když hlásíte problém podpoře. Přes MCP přichází chyba, kterou umí asistent opravit, jako výsledek nástroje s příznakem isError; chyba protokolu jako chyba JSON-RPC.

Příklady

# Objednávky za období, po stránkách
curl -H "Authorization: Bearer <váš klíč>" \
  "https://<vaše adresa>/api/v1/orders?market=cz&from=2026-08-01&to=2026-08-31&limit=50"

# Statistiky doručování za srpen
curl -H "Authorization: Bearer <váš klíč>" \
  "https://<vaše adresa>/api/v1/shipping/stats?market=cz&from=2026-08-01&to=2026-08-31"

# Statistika reklamací za srpen
curl -H "Authorization: Bearer <váš klíč>" \
  "https://<vaše adresa>/api/v1/claims/statistics?market=cz&from=2026-08-01&to=2026-08-31"

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

Otázky, na které po připojení odpoví Claude.ai z údajů MitoOps: „Jaký byl medián času doručení DHL a GLS za srpen?“, „Kolik objednávek přišlo z ChatGPT?“, „Jaká je marže produktu X za poslední měsíc?“ (s purchase-prices:read), „Kolik reklamací je po termínu?“, „Navrhni automatizaci, která u neuhrazené objednávky po třech dnech pošle upozornění“ (s automations:write — vznikne vypnutý koncept), „Přejmenuj na e-shopu CZ dostupnost Na objednávku na Do 5 dnů“ (s availabilities:draft vznikne návrh, který zapíšete schválením v aplikaci).

Bezpečnost

Izolace zákaznických prostorů. Klient pochází výhradně z kredenciálu; každý klient má vlastní databázi.
Rozsah e-shopů je průnik seznamu z kredenciálu a e-shopů, které máte připojené v té chvíli. Při voláních nad údaji jednoho e-shopu je market povinný — chybějící e-shop je 400, e-shop mimo rozsah 403.
Práva člověka. Obrazovka souhlasu nabízí jen rozsahy, které má přihlášený člověk sám; vlastní sada oprávnění účtu rozhoduje.
Hranice zápisů vynucuje služba, ne anotace: koncept automatizace vzniká vždy vypnutý, publikovaná automatizace se přes MCP nezmění a návrh změny dostupností do e-shopu nezapíše nic, dokud ho člověk neschválí v aplikaci.
Platnost a odvolání. Přístupový token OAuth platí hodinu, obnovovací 30 dní; odvolaný souhlas zastaví každý token, který z něj vznikl. Klíče lze okamžitě zrušit nebo vyměnit.
Audit. Každé volání je zapsáno se jménem schopnosti, rozhraním a otiskem vstupu — bez hodnot.
Na co se spolehnout nedá: neveřejné adresy aplikace (rozhraní je /api/v1 a /api/mcp, nic jiného), přímý přístup do databáze (neexistuje) a přístupové údaje (rozhraní je nevydává).