{"pageKey":"Developers","slug":"developers-api-integrations","locale":"sk","localeResolved":"sk","fallbackApplied":false,"version":"developers-api-integrations@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/sk/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"Merchandise API a integračné kontrakty | MerchandAise","description":"Preskúmajte kontrakty MerchandAise pre nástroje asistentov, komunitné integrácie, dodávateľské operácie a podnikovú identitu s jasne vymedzenými verejnými a chránenými prístupmi.","sections":[{"heading":"Udržujte jediný zdroj pravdy","paragraphs":["Integrácia by mala proces MerchandAise rozširovať, nie ho vetviť. Webové stránky, vložené prvky, dodávateľské, podnikové a budúce rozhrania asistentov musia čítať a aktualizovať rovnaký verziovaný dizajn, obchodný zámer, cenovú ponuku, schválenie a stav objednávky.","Tam, kde MerchandAise spracováva transakciu kupujúceho, je zmluvným predajcom a zodpovedným obchodníkom (Merchant of Record) spoločnosť Hutter Products GmbH pod značkou MerchandAise. Identita a kontaktné údaje dodávateľa zostávajú súkromné, s výnimkou prípadov, kedy sa vyžaduje ich zverejnenie, a produkcia naďalej vyžaduje schválenie digitálneho náhľadu a fyzickej vzorky z výroby."]},{"heading":"API a integračné rozhrania","items":[{"title":"Dokumentácia API pre nástroje asistentov","description":"Preskúmajte aktuálne koncové body pre asistentov a nástroje na účely dizajnových relácií a kontroly integrácie. Tento verejný referenčný zdroj neudeľuje anonymné oprávnenie na vytváranie cenových ponúk ani zadávanie objednávok. Human guide: Otvoriť dokumentáciu k nástrojom asistentov (/sk/developers/api-integrations). Machine-readable contract: OpenAPI JSON pre nástroje asistentov (/api/docs/openapi.json). Access: public. Verejná referencia pre API asistentov a nástrojov. Prístup do produkcie a operácie ovplyvňujúce objednávky naďalej vyžadujú príslušnú autorizáciu. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs."},{"title":"API pre komunitné integrácie","description":"Prepojte lokalizované klubové, komunitné alebo obchodné prostredia s dizajnovými a obchodnými procesmi MerchandAise bez nutnosti prestavby základného workflow. Human guide: Prezrieť si príručku pre komunitnú integráciu (/sk/developers/api-integrations#community-integrations). Machine-readable contract: Komunitné OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. Verejný verziovaný kontrakt pre vložené obchody, komunitné vyhľadávanie a odovzdávanie údajov s ohľadom na lokalizáciu. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations."},{"title":"Dodávateľské API","description":"Prepojte schválených dodávateľov s procesmi registrácie, katalógu, cenových ponúk a vybavovania objednávok po overení dodávateľského vzťahu a prístupového modelu. Human guide: Prezrieť si príručku pre integráciu dodávateľov (/sk/developers/api-integrations#supplier-integrations). Machine-readable contract: Dodávateľské OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. Verejný kontrakt na plánovanie a generovanie klientov. Prevádzkový prístup dodávateľov zostáva podmienený oprávneniami. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations."},{"title":"API pre podnikovú identitu","description":"Naplánujte SSO, poskytovanie používateľov cez SCIM a toky identít pripravené na audit pre schválené firemné programy reklamných predmetov a riadené nasadenia. Human guide: Prezrieť si príručku pre podnikovú integráciu (/sk/developers/api-integrations#enterprise-integrations). Machine-readable contract: OpenAPI JSON pre podnikovú identitu (/api/v1/enterprise/identity/openapi/v1). Access: protected. Chránený kontrakt pre schválené podnikové pracovné priestory; pred použitím tohto koncového bodu požiadajte o prístup. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations."}]},{"heading":"Vyberte si kontrakt ešte pred písaním kódu","items":[{"title":"Step 1: Zmapujte cestu používateľa","description":"Rozhodnite, kto a kde vstupuje do procesu: kupujúci vo vloženom obchode, schválený dodávateľ, podnikový používateľ alebo asistent pracujúci s výslovným oprávnením."},{"title":"Step 2: Potvrďte hranice prístupu","description":"Na vyhodnotenie a generovanie klientov použite verejné kontrakty, potom pred implementáciou potvrďte prihlasovacie údaje, rozsahy (scopes), prostredia, spätné volania (callbacks) a chránené koncové body."},{"title":"Step 3: Preukážte kontinuitu stavu","description":"Otestujte, či si dizajny, cenové ponuky, schválenia, chyby a odovzdania objednávok zachovávajú aktuálnu verziu v rámci celej integrácie, vrátane opakovaných pokusov a ciest pre návrat do pôvodného stavu (rollback)."}]},{"heading":"Čo musí každá integrácia zachovať","items":[{"title":"Jeden verziovaný stav","description":"Dizajn, obchodný zámer, cenová ponuka krytá dodávateľom, schválenie a stav objednávky zostávajú prepojené. Neaktuálne zmeny musia vyvolať viditeľné prepočítanie ceny alebo stav kontroly."},{"title":"Obchodné súkromie a súkromie dodávateľov","description":"MerchandAise zostáva obchodníkom komunikujúcim s kupujúcim a vlastníkom podpory. Identity dodávateľov, kontakty a interné údaje nie sú prostredníctvom verejných integrácií odhalené."},{"title":"Schválenie pred výrobou","description":"Natívne 3D zobrazenie produktu a digitálny náhľad podporujú rozhodovanie, ale nenahrádzajú skutočnú fyzickú vzorku z výroby, ktorá sa vyžaduje pred spustením sériovej výroby."}]},{"heading":"Pred spustením produkčnej prevádzky","paragraphs":["Publikovaný súbor OpenAPI slúži na plánovanie, nie je prísľubom anonymného prístupu do produkcie. Pred spustením do prevádzky kontrolujeme prostredia, prihlasovacie údaje, spracovanie chýb a prevádzkovú zodpovednosť."],"items":[{"title":"Prístup a prostredia","description":"Potvrďte verziu kontraktu, schválený pracovný priestor, rozsahy overenia (scopes), sandbox, produkčné prihlasovacie údaje a cieľové adresy pre spätné volania."},{"title":"Chyby a obnova","description":"Pred vydaním definujte opakované pokusy, idempotenciu, časové limity, chyby viditeľné pre zákazníka, monitorovanie (observability), vlastníctvo podpory a návrat do pôvodného stavu (rollback)."},{"title":"Kompletné overenie (End-to-end)","description":"Overte zamýšľanú cestu v testovacom prostredí (staging) od vstupu a zmeny stavu až po cenovú ponuku, schválenie, odovzdanie a správanie pri obnove."}]},{"heading":"Často kladené otázky","items":[{"title":"S ktorým integračným rozhraním by som mal začať?","description":"Začnite s osobou a zmenou stavu. Pre klubové alebo komunitné cesty zamerané na kupujúcich použite komunitné integrácie, pre schválené dodávateľské procesy použite dodávateľské operácie, pre SSO a SCIM použite podnikovú identitu a nástroje asistentov používajte len pre výslovne autorizované toky riadené AI."},{"title":"Znamená verejný kontrakt aj verejný prístup do produkcie?","description":"Nie. Verejný OpenAPI kontrakt slúži na oboznámenie sa s rozhraním, kontrolu architektúry a generovanie klientov. Produkčné prihlasovacie údaje, zápisové operácie, dodávateľské procesy, podniková identita a spúšťanie asistentov môžu naďalej vyžadovať schválený pracovný priestor a špecificky vymedzenú autorizáciu."},{"title":"Môže integrácia odhaliť dodávateľov alebo obísť schvaľovanie?","description":"Nie. Identita a kontaktné údaje dodávateľa zostávajú súkromné, s výnimkou prípadov, kedy sa vyžaduje ich zverejnenie. MerchandAise vlastní vzťah s kupujúcim a akcie ovplyvňujúce objednávky musia zachovať nakonfigurované schvaľovacie kroky a podmienku fyzickej vzorky."}]},{"heading":"Predstavte nám svoj proces, nie hotovú architektúru.","paragraphs":["Povedzte nám, kto bude integráciu používať, ktorý stav potrebuje čítať alebo meniť a kde bude toto prostredie fungovať. Spoločne s vami naplánujeme kontrakt, prístupový model a najbezpečnejšiu cestu nasadenia."],"items":[{"title":"Naplánovať integráciu","description":"/sk/contact?intent=api-integration-review"},{"title":"Preskúmať AI agentov a MCP","description":"/sk/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}