Za razvijalce

Preverjenopreverjeno 2026-09-20

Na kratko

MitoOps ima javni vmesnik v treh oblikah nad isto normalizirano plastjo podatkov. Razlikujejo se po tem, kdo sprašuje in kaj sme:

Oblika	Smer	Kaj sme
REST API (`/api/v1`)	sprašuje vaš program	samo branje: odgovarja izključno na `GET`, nobena operacija ničesar ne spremeni
MCP (`/api/mcp`)	sprašuje aplikacija AI	branje istih podatkov in dodatno ozki zapisi za občutljivimi obsegi, ki jih oseba podeli izrecno: `automations:write` (izklopljen osnutek avtomatizacije in predlog spremembe delujoče, ki ga objavi oseba), `coupons:write` in `coupons:delete` (kupon za popust s predogledom in potrditvijo), `affiliate:write` (upravljanje partnerskega programa: račun partnerja, besedila portala, predloge, kampanje, politika dokumentov), `affiliate:approve` (odločitev o eni imenovani proviziji, izplačila ostanejo v aplikaciji), `availabilities:draft` (predlog spremembe šifranta razpoložljivosti, ki ga v spletno trgovino zapiše šele oseba z odobritvijo v aplikaciji) in `claims-settings:draft` (predlog spremembe nastavitev reklamacij, ki ga zapiše šele oseba z odobritvijo v aplikaciji). Poleg tega `claims-routes:draft`, `product-content:draft` in `category-content:draft`: predlog povratnega prevoza reklamacij ter besedil izdelkov in kategorij, ki ga zapiše oseba z odobritvijo v aplikaciji ali takoj, če stranka za to področje zavestno vklopi samodejni zapis. Nič drugega prek MCP ne nastane in se ne spremeni
Odhodni webhooki	MitoOps pošilja vam	podpisano sporočilo o dogodku (naročilo, plačilo, pošiljka, zaloga, račun, reklamacija) na vaš naslov

Vmesnik trenutno ponuja 130 orodij MCP (102 za branje, 28 za pisanje za občutljivimi obsegi: osnutek in revizija avtomatizacije, kuponi za popust, upravljanje partnerskega programa ter predlogi sprememb razpoložljivosti, nastavitev in povratnega prevoza reklamacij ter besedil izdelkov in kategorij, ki jih zapiše šele človek z odobritvijo v aplikaciji, razen če stranka za področje zavestno vklopi samostojni zapis), 101 poti REST (vse samo za branje) in 32 obsegov dovoljenj, od tega 13 občutljivih, na 19 področjih podatkov. Številke nastanejo iz kataloga aplikacije ob sestavljanju te strani, nihče jih ne vpisuje ročno.

Kaj lahko preberete prek REST in MCP: spletne trgovine, naročila, izdelke in kategorije, zaloge z zgodovino premikov, račune in dobropise, pošiljke in statistiko dostave, obisk in kanale, finančna poročila in prodajo, imenik kupcev in analitiko kupcev v psevdonimih, dobavitelje, reklamacije s statistiko, partnerski program, avtomatizacije, šifrant razpoložljivosti trgovin, končne točke webhookov (endpointi) ter paket računa z omejitvami.

Prek MCP ni mogoče spremeniti naročila ali njegovega stanja, stanja zalog, izdelka ali tega, kakšno razpoložljivost ima izdelek, niti cene, izdati dokumenta, izvesti vračila kupnine, upravljati končnih točk webhookov, vklopiti avtomatizacije, množično odobriti provizij ali izplačati partnerja. Vsak zapis stoji za lastnim občutljivim obsegom: izklopljen osnutek avtomatizacije (vklopi ga šele oseba v aplikaciji), kupon za popust (predogled in potrditev), upravljanje partnerskega programa, odločitev o eni imenovani proviziji in predlog spremembe šifranta razpoložljivosti (v spletno trgovino ga zapiše šele oseba, ko ga odobri v aplikaciji). REST zapisovalnih klicev sploh nima. Dostopnih podatkov za prevoznike, spletno trgovino ali analitiko ni mogoče prebrati prek ničesar.

REST: samo za branje

Naslov je /api/v1 na domeni vaše aplikacije. Klici, parametri, oblika odgovora, obdobje in straničenje so opisani v vmesniku REST. Strojno berljiv opis je na /api/v1/openapi.json za istim ključem; prijavljena oseba ga odpre tudi z zaslona Nastavitve → API & MCP. Opis nastane iz istega vira kot vmesnik, zato se z njim ne razhaja.

Karkoli drugega kot GET prejme 405, še preden strežnik pogleda ključ. To ni začasna omejitev: REST v1 zapisovalnih klicev nima in zapisi MCP vanj namerno niso bili vključeni. Predlog spremembe razpoložljivosti prek REST samo preberete (njegovo stanje), pripraviti ga prek REST ni mogoče.

MCP: branje in ozki zapisi

Naslov je /api/mcp. MitoOps je standarden oddaljeni strežnik MCP (Model Context Protocol, odprt protokol, neodvisen od ponudnika AI); poveže se lahko vsaka aplikacija, ki podpira oddaljeni MCP prek HTTP z OAuth ali z dostopnim ključem. Claude.ai je v produkciji preverjen odjemalec; natančen postopek je v vmesniku MCP.

Orodja MCP stojijo na istih zmožnostih kot REST, zato to ni drugi vmesnik z lastnimi poizvedbami. Seznam orodij se ravna po obsegih ključa ali soglasja: orodje zunaj obsega za aplikacijo ne obstaja. Vsako orodje nosi opombe po reviziji protokola 2026-07-28 (readOnlyHint, destructiveHint, idempotentHint), iz katerih aplikacija AI ve, ali gre za branje ali za zapis.

OAuth: povezava v imenu osebe

Aplikacija AI, ki podpira oddaljeni MCP z OAuth, se ne povezuje s ključem. Vnesete ji naslov /api/mcp, ona vas pošlje na prijavo v MitoOps (tudi z drugim faktorjem) in na zaslonu soglasja izberete, kaj sme brati, katerih spletnih trgovin se to tiče in katere zapise sme izvajati (osnutki avtomatizacij, kuponi, upravljanje partnerskega programa, odločitev o proviziji, predlogi sprememb razpoložljivosti). Gesla aplikacija nikoli ne vidi.

O tem, kaj se preda, odloča prijavljena oseba, in nikoli ne preda več, kot sme sama. Kdor nima pravice do nabavnih cen, je ne more predati naprej; kdor ne sme urejati avtomatizacij, obsega automations:write na zaslonu soglasja sploh ne vidi. Soglasje OAuth ne porabi dostopnega ključa iz omejitve paketa, vendar zahteva paket z API & MCP; brez njega se zaslon soglasja ne odpre in pove, zakaj.

Dovoljenje lahko kadarkoli odvzamete v Nastavitve → API & MCP in vsi dostopi, ki izhajajo iz njega, prenehajo veljati v istem trenutku.

Dostopni ključ

Za strežnik, ki kliče strežnik, ali za vaš lasten program:

V aplikaciji odprite Nastavitve → API & MCP in kliknite Nov ključ.
Vnesite ime, po katerem boste ključ kasneje prepoznali.
Izberite obsege, trgovine in vmesnike (REST, MCP ali oba).
Izberite veljavnost in ključ ustvarite.

Ključ se pošilja v glavi; v naslovu URL se namerno ne sprejema (naslovi se zapisujejo v dnevnike in v zgodovino brskalnika):

Authorization: Bearer <vaš ključ>

Obsegi pravic

Ključ ali soglasje nikoli ne vidi več, kot mu je bilo dodeljeno. Tabela nastane iz kataloga aplikacije:

Obseg	Dostop	Občutljiv	Do česa omogoča dostop
`stores:read`	branje	ne	seznam spletnih trgovin s kodo
`orders:read`	branje	ne	naročila vključno s postavkami; naslov samo država in kraj, zneski samo z `reports:read`
`products:read`	branje	ne	izdelki, kategorije in prodajna cena s kartice izdelka
`invoices:read`	branje	ne	računi s postavkami, dobropisi in predračuni
`shipping:read`	branje	ne	pošiljke, dogodki sledenja, prevozniki (brez dostopnih podatkov) in statistika dostave
`analytics:read`	branje	ne	obisk, kanali, rezultati v iskanju in pokritost naročil z merjenjem
`search-console:read`	branje	ne	uspešnost v Googlovem iskanju iz sinhroniziranega arhiva: dnevi, poizvedbe, strani, države in naprave
`inventory:read`	branje	ne	stanje zalog in zgodovina premikov zalog
`reports:read`	branje	občutljiv	promet s primerjavo in po mesecih, oglaševanje (stroški, proračun, ROAS, PNO, CPA, MER), kdaj prihajajo naročila, viri prometa; finančni povzetek obdobja (promet, DDV, stroški, rezultat), prodaja po izdelkih, uspešnost po naročilih, kupci kot psevdonimi in zneski v množičnem izpisu naročil
`purchasing:read`	branje	občutljiv	dobavitelji, njihove ponudbe in stroškovne komponente
`claims:read`	branje	ne	reklamacije in vračila s povezavami na naročilo, dobropis in povratno pošiljko, časovnica in poslana e-poštna sporočila primera; statistika in procesi modula
`automations:read`	branje	ne	katalog sprožilcev in dejanj, seznam avtomatizacij, njihove nastavitve, zgodovina izvajanj in validacija osnutka
`automations:write`	pisanje	občutljiv	ustvarjanje ali urejanje izklopljenega osnutka avtomatizacije in predlog spremembe vklopljene avtomatizacije (revizija); vklopiti osnutek in objaviti revizijo lahko samo oseba v aplikaciji, delujoča avtomatizacija se s predlogom ne spremeni
`webhooks:read`	branje	ne	katalog dogodkov, končne točke brez skrivnosti in dnevnik dostav brez vsebine sporočil
`account:read`	branje	ne	paket, vklopljene funkcije in omejitve s trenutno porabo
`affiliate:read`	branje	ne	partnerski program: pregled, partnerji, kampanje, kode za popust, konverzije, izplačila, statistika, nastavitve, dokumenti, javni portal, predloge e-poštnih sporočil, članki pomoči in zahteve za kodo; kontakt partnerja samo s `personal-data:read`, bančni in davčni podatki nikoli
`affiliate:write`	pisanje	občutljiv	upravljanje partnerskega programa: odločitev o računu partnerja (odobriti, zavrniti, začasno ustaviti), obravnava zahteve za kodo, nastavitve programa razen denarnih, besedila portala, članki pomoči, predloge e-poštnih sporočil, kampanje in politika dokumentov; odločitev o proviziji ima lasten obseg, izplačila ostanejo v aplikaciji
`affiliate:approve`	pisanje	občutljiv	odločitev o eni proviziji partnerskega programa po id konverzije: odobriti, zavrniti ali preklicati (zavrnitev in preklic z razlogom, partner prejme e-poštno sporočilo); izplačana provizija se ne vrača, množične odobritve in izplačil od zunaj ni
`customers:read`	branje	ne	imenik kupcev: psevdonim, trgovine, država, jezik, skupna števila in datumi za celotno obdobje; ime, podjetje, e-pošta in telefon samo s `personal-data:read`, promet in LTV samo z `reports:read`
`coupons:read`	branje	ne	kuponi za popust spletne trgovine z višino popusta in veljavnostjo, podpora platforme, aktivacijska povezava in njena pripravljenost
`coupons:write`	pisanje	občutljiv	ustvarjanje kupona v izbranih spletnih trgovinah (obstoječi kupon z drugimi parametri se brez izrecnega soglasja ne prepiše)
`coupons:delete`	pisanje	občutljiv	nepovraten izbris kupona v izbrani spletni trgovini po predogledu in izrecni potrditvi; kupon z živo odvisnostjo (AI Mailing, okno za prijavo, načrtovana kampanja, partner) se ne izbriše
`chatbot:read`	branje	ne	statistika spletnega klepetalnika za obdobje: prikazi in kliki obvestila (stopnja klikov), odprtja klepeta skupaj s tem, kako so nastala, število pogovorov in sporočil, izidi, ocene kupcev, lijak prijav na novičnik in deterministična ocena tem pogovorov (deleži, izdelki, kandidati za vrzel v znanju); samo seštevki
`chatbot-conversations:read`	branje	občutljiv	pogovori kupcev s spletnim klepetalnikom: seznam s prvim vprašanjem in prepis z viri odgovorov robota; kupec je samo naključni ključ pogovora, e-pošta, telefon in IBAN v besedilu samo s `personal-data:read`, sicer nadomeščeni z oznako; samo v okviru hrambe spletne trgovine
`availabilities:draft`	pisanje	občutljiv	predlog spremembe šifranta razpoložljivosti spletne trgovine (ustvariti, urediti, izbrisati) s predogledom; v spletno trgovino ga zapiše šele oseba s pravico, ko ga odobri v aplikaciji, sicer po 24 urah poteče; dodelitve razpoložljivosti izdelkom in stanja zalog ne spreminja
`claims-settings:read`	branje	ne	predloge e-poštnih sporočil in zapisnikov reklamacij, nastavitve modula, oznake, povratna dostava in obrazec v spletni trgovini; brez dostopnih žetonov
`claims-settings:draft`	pisanje	občutljiv	predlog spremembe procesov, stanj, oznak in besedil predlog reklamacij s predogledom; zapiše ga šele oseba s pravico z odobritvijo v aplikaciji, sicer po 72 urah poteče; ničesar ne briše
`claims-routes:draft`	pisanje	občutljiv	predlog za ustvarjanje, spremembo, vklop ali izklop povratne poti, preverjen kot na zaslonu; zapiše ga človek z odobritvijo v aplikaciji ali takoj, če je stranka za področje zavestno vklopila samostojni zapis; poti nikoli ne izbriše
`product-content:read`	branje	ne	opis, kratek opis in SEO besedila izdelka neposredno iz spletne trgovine, s prstnim odtisom in zapisljivostjo vsakega polja
`product-content:draft`	pisanje	občutljiv	predlog novih besedil izdelkov (največ 30 hkrati), samo vsebinska polja, nikoli cena, zaloga, koda ali EAN; zapiše ga človek z odobritvijo ali takoj pri zavestno vklopljenem samostojnem zapisu
`category-content:read`	branje	ne	zgornji in spodnji opis ter SEO besedila kategorije, s prstnim odtisom in zapisljivostjo glede na platformo spletne trgovine
`category-content:draft`	pisanje	občutljiv	predlog novih besedil kategorij (največ 30 hkrati), samo polja, ki jih platforma spletne trgovine zna zapisati; zapiše ga človek z odobritvijo ali takoj pri zavestno vklopljenem samostojnem zapisu

Občutljivi obsegi niso vnaprej izbrani niti na zaslonu za izdajo ključa niti na zaslonu soglasja, oseba jih mora označiti zavestno. purchase-prices:read in personal-data:read nimata lastnega orodja; odločata o poljih v odgovorih drugih orodij. Manjkajoče polje ni ničelno, temveč manjka.

Obsegi so javna zaveza: spreminjajo se samo povratno združljivo, poverilnica, izdana prej, pa novega obsega ne podeduje (obsegi so v njej zapisani poimensko). Zato starejši ključ ali starejše soglasje ni prejelo osebnih podatkov, ko je zanje 2. 9. 2026 nastal lasten obseg, in ne bo prejelo niti zapisa osnutka: za to je potrebno novo soglasje ali nov ključ.

Obstoječemu ključu lahko nov obseg dodate tudi brez zamenjave ključa: Nastavitve → API & MCP → Uredi obsege. Vrednost ključa ostane enaka, integracija, ki ga uporablja, deluje naprej in nov obseg dobi od naslednje zahteve. Spremembo izvede oseba s pravico upravljanja ključev; tarifa in občutljivi obsegi se preverijo enako kot pri izdaji.

Osebni podatki

Vmesnik izdaja operativne podatke, osebne pa samo z obsegom personal-data:read:

Naročila in reklamacije brez njega vračajo samo državo in kraj, ne pa imena, e-pošte, telefona ali ulice.
Imenik kupcev (customers:read) sam izda samo psevdonim, trgovine, državo, jezik, števila in datume. Ime, podjetje, e-pošto, telefon in marketinški spol doda šele personal-data:read, promet in LTV šele reports:read; manjkajoče polje se odstrani, ne nastavi na nič.
Analitika kupcev (customers/performance) osebnih podatkov sploh nima: kupec je psevdonim (odtis e-poštnega naslova), enak kot customerEmailHash na dokumentih in v imeniku.
Kontakt dobavitelja in partnerja programa je za istim obsegom.
Pogovori s spletnim klepetalnikom (chatbot-conversations:read, občutljiv) nosijo samo naključni ključ pogovora, brez imena, e-pošte, IP ali piškotka. E-pošto, telefon in IBAN, ki jih je kupec napisal v besedilo, izda šele personal-data:read; brez njega je na njihovem mestu oznaka.
Bančni in davčni podatki partnerjev (IBAN, matična številka, davčna številka, podatki za obračun izplačil), interni zapiski, gesla in skrivnosti drugega faktorja se ne izdajo nikoli, noben obseg jih ne odpre.
Webhooki pošiljajo identifikatorje in stanja, ne pa vsebine naročila ali podatkov kupca.

Vsak klic se zapiše v revizijsko sled brez vrednosti vnosa, samo z imeni polj in odtisom.

Avtomatizacije: varen zapis osnutka

Pomočnik AI sme avtomatizacijo predlagati, ne sme pa je vklopiti. Z obsegom automations:write (občutljiv, nikoli vnaprej izbran, ponudi se samo osebi s pravico urejati avtomatizacije):

automations_create_draft ustvari osnutek v stanju izklopljeno; ne dotakne se objavljene različice, sprožilcev ali izvajanja;
automations_update_draft uredi samo osnutek, ki ga še nihče ni objavil; osnutek, ki se ureja v urejevalniku aplikacije, se ne prepiše;
osnutek se prikaže v Avtomatizacije kot vsak nedokončan osnutek in vklopiti, objaviti ali zagnati ga lahko samo oseba v aplikaciji s pravico odobritve;
automations_revision_create_draft predlaga spremembo objavljene, tudi vklopljene avtomatizacije kot revizijo; delujoča različica se ne spremeni, dokler oseba revizije ne naloži v urejevalniku in je ne objavi (automations_revision_update_draft, automations_revision_discard_draft).

Vrednosti polj, ki se v urejevalniku izbirajo s seznama (stanje naročila, dostava, plačilo, stanje reklamacije…), vrne automations_options v obliki, ki jo shrani urejevalnik. Vrednost, ki v spletni trgovini ne obstaja, in nadomestno besedilo, kot je DOPLNIT_…, sta napaka validacije, ne uspeh.

Ustvarjanje je idempotentno prek clientRequestId, urejanje zahteva expectedVersion, obe operaciji pa zahtevata catalogVersion iz automations_catalog; zastarel katalog je konflikt, ne tih zapis. Osnutek, ki sega na neznan sprožilec, spletno trgovino zunaj obsega ali tujo končno točko webhooka, se ne shrani. Podrobnosti so v vmesniku MCP.

Razpoložljivosti: predlog spremembe, ki ga odobri oseba

Razpoložljivosti so postavke šifranta konkretne spletne trgovine, ki jih trgovina prikazuje pri izdelku, na primer Na zalogi, Na naročilo ali Predprodaja: ime, opis, čas do uskladiščenja in čas dostave v urah, pomen za Google Nakupovanje in barva. To ni stanje zalog.

availabilities_list in GET /availabilities?market= (obseg products:read) vrneta šifrant ene spletne trgovine; market je obvezen. Polje manageable pove, ali je šifrant te trgovine mogoče spreminjati v MitoOps, reason pa, zakaj ne: PLATFORMA (platforma tega ne omogoča), BEZ_ROZSIRENIA (spletni trgovini WooCommerce manjka vtičnik MitoOps) ali PROSTREDIE (zapis v spletne trgovine je v tem okolju izklopljen).
availabilities_change_draft (samo MCP, občutljiv obseg availabilities:draft) v spletno trgovino ne zapiše ničesar. Spremembo preveri, jo shrani kot predlog, veljaven 24 ur, in vrne predogled (vsako polje pred spremembo in po njej, opozorila, blokade), draftId in approvalUrl.
V spletno trgovino predlog zapiše šele oseba v aplikaciji z gumbom Potrdi in zapiši v Zaloga | Izdelki → Razpoložljivosti → Upravljanje, lahko pa ga tudi zavrne. Pri tem odločajo njene pravice v trenutku klika, ne obseg ključa ali soglasja. Niti model niti dostopni ključ brez osebe v spletno trgovino ne zapiše ničesar.
availabilities_draft_get in GET /availabilities/drafts/:draftId (obseg products:read) vrneta stanje predloga: pending, writing, executed, partial, failed, rejected ali expired.

Obseg availabilities:draft se ponudi samo osebi, ki bi spremembo smela tudi odobriti (pravica upravljati sinhronizacijo zalog in urejati izdelke). Obstoječi ključ ali soglasje ga ne podeduje. REST v1 ostaja samo za branje. Parametri predloga so v vmesniku MCP, zaslon za odobritev pa v navodilu Razpoložljivosti.

Reklamacije: nastavitve za branje in predlog spremembe

claims_settings (obseg claims:read) vrne procese z ID-ji in imeni vrst, korakov in stanj ter oznake; z obsegom claims-settings:read tudi nastavitve modula.
claims_templates in claims_configuration (obseg claims-settings:read) vrneta predloge e-poštnih sporočil in zapisnikov (zadeva, besedilo, kdaj in ali se pošiljajo samodejno) ter ostale nastavitve: oznake, polja, povratno dostavo in obrazec v spletni trgovini, brez žetona integracije.
claims_get nosi tudi časovnico primera, poslana e-poštna sporočila in oznake; besedilo sporočil samo s personal-data:read.
claims_config_change_draft (samo MCP, občutljiv obseg claims-settings:draft) nastavitev ne spremeni. Predlog spremembe procesov, stanj, oznak in besedil predlog shrani za 72 ur s predogledom in approvalUrl; zapiše ga šele oseba s pravico upravljati nastavitve z gumbom Odobri in zapiši v Reklamacije → Nastavitve, v celoti ali sploh ne. Stanje vrne claims_config_draft_get.

Parametri so v vmesniku MCP.

Povratni prevoz, besedila izdelkov in samostojni zapis

claims_routes (obseg claims-settings:read ali kateri koli obseg predlogov reklamacij) vrne poti povratnega prevoza, naslove prejemnika, profile prevoznikov z ID-jem, oznako vračila in dosegom ter ključe vrst primerov. claims_routes_change_draft (samo MCP, občutljiv obseg claims-routes:draft) predlaga ustvarjanje, spremembo, vklop ali izklop poti. Strežnik jo preveri enako kot zaslon: profil z vklopljenim vračilom, doseg prevoznika, obstoječ naslov in vrste, nenegativna cena in brez spora z vklopljeno potjo. Brisanja poti prek MCP ni.
products_content_get in GET /products/:code/content?market= (obseg product-content:read) vrneta opis, kratek opis in SEO besedila izdelka neposredno iz spletne trgovine, vsako polje s prstnim odtisom (hash) in podatkom, ali ga platforma zna zapisati. categories_content_get in GET /categories/:guid/content?market= (obseg category-content:read) vrneta isto za kategorijo.
products_content_change_draft in categories_content_change_draft (samo MCP, občutljiva obsega product-content:draft in category-content:draft) predlagata nova besedila, največ 30 postavk hkrati. Sprejmeta samo vsebinska polja; cene, zaloge, razpoložljivosti, kode, EAN ali imena tako ne spremenite. HTML se preveri: brez skripta razen enega bloka JSON-LD FAQPage, brez on…, javascript: ali iframe. Ob odobritvi se besedilo primerja s stanjem spletne trgovine, in če ga je kdo medtem spremenil, se ne zapiše nič (CHANGED_SINCE_DRAFT). Če spletna trgovina besedilo ob shranjevanju spremeni, rezultat to pove (MODIFIED_BY_PLATFORM). Predlogi se odobrijo v Zaloga → Spremembe izdelkov. Na WooCommerce se predlog s skriptom (tudi JSON-LD) ali s poševnico nazaj blokira (PLATFORM_STRIPS_SCRIPT, PLATFORM_STRIPS_BACKSLASH): WordPress ju ob shranjevanju odstrani, preostanek pa bi kupci videli kot besedilo.
products_content_policy in GET /product-content/policy?market= (obseg product-content:read) povesta, brez klica spletne trgovine, kaj sme vaš ključ v določeni spletni trgovini početi z besedili: ali sme brati (readEnabled) in predlagati (draftEnabled, predlog samo prek MCP), katera polja platforma zapiše (supportedFields; SEO polja na WooCommerce samo s SEO vtičnikom), način odobritve (approvalMode: human, autonomous ali disabled) in ali se predlog zapiše sam (autonomousWriteEnabled), omejitve predlogov in algoritem prstnih odtisov (sha256). Ustavljena spletna trgovina, nepodprta platforma ali ključ spletne trgovine samo za branje so status in reason v odgovoru, ne napaka. Polje category nosi isto za kategorije. Polje structuredData pove, ali platforma ohrani strukturirane podatke v opisu izdelka: na WooCommerce ne (NOT_SUPPORTED, PLATFORM_STRIPS_SCRIPT; tam strukturirane podatke upravlja tema trgovine, THEME_MANAGED), na Shoptetu da (en blok FAQPage).
Samostojni zapis. Privzeto vsak predlog (nastavitve in poti reklamacij, besedila izdelkov in kategorij) zapiše šele človek z odobritvijo. Skrbnik ga lahko za posamezno področje vklopi v Nastavitve → API & MCP → Zapis prek AI. Predlog se nato zapiše takoj, po isti poti kot odobritev, v imenu osebe, ki je AI dodelila dostop, in samo če ima ta oseba prav zdaj pravico odobriti spremembo. Sicer predlog čaka in odgovor pove, zakaj. Vsaka sprememba načina se zabeleži.

Obstoječi ključ ali soglasje novih obsegov ne podeduje; potrebno je novo soglasje.

Odhodni webhooki

REST in MCP sta branje na zahtevo. Kadar naj vaš sistem za dogodek izve takoj (novo naročilo, plačilo, sprememba stanja, pošiljka, dostava, premik zaloge, račun, reklamacija), se nanj naroči prek odhodnih webhookov: MitoOps na vaš naslov pošlje kratko ovojnico z identifikatorji, podpisano s HMAC-SHA256, s ponavljanjem ob neuspehu in dnevnikom poskusov. Podrobnosti sistem nato naloži prek REST.

Naročnine na dogodke ustvarja oseba v aplikaciji na istem zaslonu kot ključe; prek REST in MCP se končne točke samo berejo (webhooks:read, brez skrivnosti). Končno točko lahko uporabite tudi kot korak avtomatizacije. Podrobnosti so v odhodnih webhookih.

Omejitve računa

API & MCP in webhooki so del vsakega plačljivega paketa od paketa Start navzgor. Paketi se razlikujejo po številu aktivnih ključev in končnih točk, ne po tem, kaj je mogoče prebrati:

Paket	API & MCP	Aktivni dostopni ključi	Končne točke webhookov
Preizkusna različica	-	0	0
Začetnik	-	0	0
Start	da	1	5
Rast	da	2	20
Pro	da	5	50
Po meri	da	po dogovoru	po dogovoru

Omejitve uveljavlja strežnik: poskus dodati ključ ali končno točko nad omejitvijo se konča z zavrnitvijo in razlago. Zamenjava ključa in rotacija skrivnosti končne točke mesta ne porabita. Znižanje paketa obstoječih ključev ali končnih točk ne odstrani; novih samo ni mogoče ustvariti, dokler število ne pade pod novo zgornjo mejo. Povezava prek OAuth ključa ne porabi.

Trenutne vrednosti za vaš račun vključno s porabo (aktivne avtomatizacije, izvajanja v tem mesecu, e-poštna sporočila, krediti) izda account_entitlements / GET /account/entitlements z obsegom account:read. Nosi samo paket, funkcije in omejitve, brez podatkov za obračun. Trenutni cenik je na mitoops.com/en/cennik.

Zgornje meje klicev

Zgornja meja	Na čem se meri	Koliko
pred preverjanjem pristnosti	naslov, s katerega kličete	300 klicev / 60 s
po preverjanju pristnosti	konkreten ključ	600 klicev / 60 s

Prva preprečuje ugibanje ključev, druga je vaša in je ne delite z nikomer. Prekoračitev vrne 429 z glavami RateLimit-*. To ni količina iz paketa: klici se ne zaračunavajo.

Napake

Odgovor ob napaki ima vedno enako obliko in nosi kodo:

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

Stanje	Koda	Kdaj
`400`	`invalid_request`	parameter ne ustreza opisu (napačen datum, obrnjeno obdobje, neveljaven kazalec)
`400`	`store_required`	klic nad podatki spletne trgovine brez `market`
`401`	`unauthorized`	manjkajoč, neznan, preklican ali neveljaven ključ
`403`	`forbidden`	ključ nima potrebnega obsega
`403`	`store_forbidden`	spletna trgovina zunaj obsega ključa
`404`	`not_found`	zapis ne obstaja (tudi kadar pripada drugi spletni trgovini)
`405`	-	karkoli drugega kot `GET` (REST)
`409`	`conflict`	zapis osnutka je naletel na drugo različico, že uporabljen `clientRequestId` ali spremenjen katalog (MCP)
`429`	`rate_limited`	prekoračena tehnična zgornja meja klicev

Razlog zavrnitve pri 401 se ne razlikuje, ker bi razlika pomagala tistemu, ki ugiba ključe. requestId navedite, ko težavo prijavljate podpori. Prek MCP pride napaka, ki jo pomočnik lahko odpravi, kot rezultat orodja z zastavico isError, napaka protokola pa kot napaka JSON-RPC.

Primeri

# Naročila za obdobje, po straneh
curl -H "Authorization: Bearer <vaš ključ>" \
  "https://<vaš naslov>/api/v1/orders?market=sk&from=2026-08-01&to=2026-08-31&limit=50"

# Statistika dostave za avgust
curl -H "Authorization: Bearer <vaš ključ>" \
  "https://<vaš naslov>/api/v1/shipping/stats?market=sk&from=2026-08-01&to=2026-08-31"

# Statistika reklamacij za avgust
curl -H "Authorization: Bearer <vaš ključ>" \
  "https://<vaš naslov>/api/v1/claims/statistics?market=sk&from=2026-08-01&to=2026-08-31"

# Paket in omejitve računa s porabo
curl -H "Authorization: Bearer <vaš ključ>" \
  "https://<vaš naslov>/api/v1/account/entitlements"

Vprašanja, na katera po povezavi odgovori Claude.ai iz podatkov MitoOps: „Kakšen je bil mediani čas dostave DHL in GLS v avgustu?“, „Koliko naročil je prišlo iz ChatGPT?“, „Kakšna je marža izdelka X v zadnjem mesecu?“ (s purchase-prices:read), „Koliko reklamacij je po roku?“, „Predlagaj avtomatizacijo, ki pri neplačanem naročilu po treh dneh pošlje opomnik“ (z automations:write nastane izklopljen osnutek), „V spletni trgovini SK preimenuj razpoložljivost Na naročilo v Do 5 dni“ (z availabilities:draft nastane predlog, ki ga zapišete z odobritvijo v aplikaciji).

Varnost

Izolacija naročnikov. Naročnik se določi izključno iz poverilnice; vsak naročnik ima lastno podatkovno bazo.
Obseg spletnih trgovin je presek seznama iz poverilnice in spletnih trgovin, ki jih imate v tistem trenutku povezane. Pri klicih nad podatki ene spletne trgovine je market obvezen: manjkajoča trgovina vrne 400, trgovina zunaj obsega 403.
Pravice osebe. Zaslon soglasja ponuja samo obsege, ki jih ima prijavljena oseba sama; odloča lasten nabor pravic računa.
Meje zapisov uveljavlja storitev, ne opomba: osnutek avtomatizacije vedno nastane izklopljen, objavljena avtomatizacija se prek MCP ne spremeni, predlog spremembe razpoložljivosti pa v spletno trgovino ne zapiše ničesar, dokler ga oseba ne odobri v aplikaciji.
Veljavnost in preklic. Dostopni žeton OAuth velja eno uro, žeton za osvežitev 30 dni; preklicano soglasje ustavi vsak žeton, ki je nastal iz njega. Ključe je mogoče takoj preklicati ali zamenjati.
Revizijska sled. Vsak klic je zapisan z imenom zmožnosti, vmesnikom in odtisom vnosa, brez vrednosti.
Na kaj se ni mogoče zanesti: nejavni naslovi aplikacije (vmesnik je /api/v1 in /api/mcp, nič drugega), neposreden dostop do podatkovne baze (ne obstaja) in dostopni podatki (vmesnik jih ne izdaja).