{"pageKey":"Developers","slug":"developers-api-integrations","locale":"sk","localeResolved":"sk","fallbackApplied":false,"version":"developers-api-integrations@2026-11-19T22:38:19.259Z","lastModified":null,"canonicalUrl":"https://www.merchandaise.com/sk/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"Dokumentácia API a integrácie OpenAPI | MerchandAise","description":"Preskúmajte API a OpenAPI MerchandAise pre produkty s vlastným dizajnom, vložené komunity, dodávateľské procesy a firemnú identitu.","sections":[{"heading":"Vyberte prepojenie podľa potrieb svojho projektu","paragraphs":["Pomocou odkazov nižšie posúďte koncové body, formáty požiadaviek a požiadavky na autorizáciu. Verejné špecifikácie slúžia na plánovanie a generovanie klientov; prevádzkový prístup závisí od API, účtu a prostredia.","Ak MerchandAise spracúva nákupnú transakciu, zmluvným predávajúcim a obchodníkom zodpovedným za transakciu pod značkou MerchandAise je Hutter Products GmbH. Identita a kontakty dodávateľov zostávajú súkromné, okrem prípadov povinného zverejnenia. Výroba naďalej vyžaduje schválenie digitálneho náhľadu, potvrdenie vyrobiteľnosti, povinné technické kontroly a schválenie vzoriek podľa presných podmienok prijatej objednávky."]},{"heading":"API a integračné rozhrania","items":[{"title":"Dokumentácia API a OpenAPI","description":"Nájdite referenciu API pre nástroje asistenta a relácie navrhovania. Potom vyberte komunitné, dodávateľské alebo firemné rozhranie pre svoj postup. Sprievodca implementáciou: Otvoriť dokumentáciu nástrojov asistenta (/api/docs). Strojovo čitateľná špecifikácia: OpenAPI JSON nástrojov asistenta (/api/docs/openapi.json). Prístup: Verejný. Verejná referencia pre API asistenta a nástrojov. Produkčný prístup a operácie ovplyvňujúce objednávky naďalej vyžadujú príslušnú autorizáciu. Kanonická stránka: /sk/developers/api-integrations. Kanonická sekcia: /sk/developers/api-integrations#api-docs."},{"title":"Komunitné API","description":"Prepojte web klubu alebo komunity s verejnými informáciami o komunite, návrhmi dizajnov, hlasovaním a odovzdaním objednávky na schválenie. Čo rozhranie pokrýva: Verejný kontext komunity, dizajnové príspevky a hlasy, zverejnenie ponúk, čakajúce objednávky a ich schválenie alebo zamietnutie vlastníkom komunity. Praktický prvý krok: Načítajte verejné údaje komunity pre klubový web. Pred pridaním návrhov dizajnov alebo prechodu k objednávke určte, ktoré akcie vyžadujú reláciu člena alebo oprávnenia vlastníka. Prístup: Špecifikácia je verejná. Verejné čítanie, akcie členov a operácie vyhradené vlastníkovi majú odlišné požiadavky na autorizáciu; riaďte sa bezpečnostnými pravidlami každého koncového bodu. Sprievodca implementáciou: Preskúmať komunitné API (/sk/developers/api-integrations#community-integrations). Strojovo čitateľná špecifikácia: OpenAPI JSON komunity (/api/v1/community/public/openapi/v1). Prístup: Verejný. Verejná verziovaná špecifikácia pre vložené predajne, objavovanie komunít a odovzdanie s príslušným jazykom. Kanonická stránka: /sk/developers/api-integrations. Kanonická sekcia: /sk/developers/api-integrations#community-integrations."},{"title":"API dodávateľov","description":"Prepojte systémy schválených dodávateľov s uvoľnenými výrobnými balíkmi, stavom registrácie a webhookmi ERP alebo PLM. Čo rozhranie pokrýva: Stav registrácie dodávateľa, uvoľnené výrobné balíky, auditované sťahovanie podkladov, analytiku, odbery webhookov a kontrolné body synchronizácie. Praktický prvý krok: Naplánujte prepojenie systému ERP alebo správy životného cyklu produktov s dodávateľským centrom. Pred spracovaním pridelenej objednávky skontrolujte dáta webhookov, opakovanie požiadaviek a stav synchronizácie. Prístup: Špecifikáciu OpenAPI si môžete prečítať bez prihlásenia. Prevádzkové požiadavky vyžadujú príslušný dodávateľský účet a oprávnenia. Verejná dokumentácia dodávateľa neregistruje ani neposkytuje prístup k údajom iného dodávateľa. Sprievodca implementáciou: Preskúmať API dodávateľov (/sk/developers/api-integrations#supplier-integrations). Strojovo čitateľná špecifikácia: OpenAPI JSON dodávateľov (/api/v1/supplier/openapi/v1). Prístup: Verejný. Verejná špecifikácia na plánovanie a generovanie klientov. Prevádzkový prístup dodávateľa zostáva viazaný na oprávnenia. Kanonická stránka: /sk/developers/api-integrations. Kanonická sekcia: /sk/developers/api-integrations#supplier-integrations."},{"title":"API firemnej identity","description":"Prepojte schválené firemné pracovné priestory s jednotným prihlásením, správou používateľov a skupín a auditnými záznamami identity. Čo rozhranie pokrýva: Jednotné prihlásenie OpenID Connect (OIDC), operácie životného cyklu používateľov a skupín SCIM, rotáciu tokenov SCIM a auditné udalosti správy účtov. Praktický prvý krok: Prepojte svojho poskytovateľa identity so schváleným pracovným priestorom. Naplánujte prihlasovanie, vytváranie a rušenie účtov a potom overte mapovanie skupín a auditné záznamy v dohodnutom testovacom prostredí. Prístup: Špecifikácia firemnej identity je chránená. Pred implementáciou preberte pracovný priestor a požiadavky na prístup s integračným tímom. Firemná identita nie je povinná pri bežnom nákupe produktov. Sprievodca implementáciou: Preskúmať firemnú identitu (/sk/developers/api-integrations#enterprise-integrations). Strojovo čitateľná špecifikácia: OpenAPI JSON firemnej identity (/api/v1/enterprise/identity/openapi/v1). Prístup: Chránený. Chránená špecifikácia pre schválené firemné pracovné priestory. Pred použitím tohto koncového bodu požiadajte o prístup. Kanonická stránka: /sk/developers/api-integrations. Kanonická sekcia: /sk/developers/api-integrations#enterprise-integrations."}]},{"heading":"Najprv vyberte rozhranie, potom píšte kód","items":[{"title":"Krok 1: Zmapujte cestu používateľa","description":"Určte, kto a kde vstupuje do procesu: kupujúci vo vloženej predajni, schválený dodávateľ, firemný používateľ alebo asistent s výslovnou autorizáciou."},{"title":"Krok 2: Potvrďte hranice prístupu","description":"Verejné špecifikácie použite na posúdenie a generovanie klientov. Pred implementáciou potvrďte prihlasovacie údaje, rozsahy oprávnení, prostredia, spätné volania a chránené koncové body."},{"title":"Krok 3: Overte nadväznosť stavov","description":"Otestujte, že dizajny, ponuky, schválenia, chyby a odovzdania objednávok zachovávajú aktuálnu verziu naprieč integráciou vrátane opakovaných požiadaviek a návratu k predchádzajúcemu stavu."}]},{"heading":"Čo musí každá integrácia zachovať","items":[{"title":"Jeden verziovaný stav","description":"Dizajn, nákupný zámer, ponuka potvrdená dodávateľom, schválenie a stav objednávky zostávajú prepojené. Zastarané zmeny musia vyvolať viditeľné opätovné nacenenie alebo kontrolu."},{"title":"Ochrana obchodných a dodávateľských údajov","description":"MerchandAise zostáva obchodníkom a kontaktným miestom podpory pre kupujúceho. Verejné integrácie nezverejňujú identitu, kontakty ani interné údaje dodávateľov."},{"title":"Schválenie pred výrobou","description":"3D náhľad nie je fyzický dôkaz. Potvrdená ponuka vysvetľuje dostupné možnosti zákazníckych vzoriek, náklady, obmedzenia a termíny. Pred sériovou výrobou schváľte presný digitálny náhľad, dokončite povinné technické kontroly a schváľte požadované alebo zvolené vzorky. Požiadavky už prijatých objednávok zostávajú záväzné."}]},{"heading":"Pred spustením produkčnej prevádzky","paragraphs":["Zverejnený súbor OpenAPI slúži na plánovanie; nesľubuje anonymný prístup do produkcie. Pred spustením preverujeme prostredia, prihlasovacie údaje, riešenie chýb a prevádzkovú zodpovednosť."],"items":[{"title":"Prístup a prostredia","description":"Potvrďte verziu rozhrania, schválený pracovný priestor, autentifikačné oprávnenia, testovacie prostredie, produkčné prihlasovacie údaje a adresy spätných volaní."},{"title":"Chyby a obnova","description":"Pred vydaním určte opakovanie požiadaviek, idempotentnosť, časové limity, chyby viditeľné zákazníkovi, sledovanie prevádzky, zodpovednosť podpory a návrat k predchádzajúcej verzii."},{"title":"Dôkazy z celého procesu","description":"V testovacom prostredí overte plánovanú cestu od vstupu a zmeny stavu cez ponuku a schválenie až po odovzdanie a zotavenie po chybe."}]},{"heading":"Časté otázky","items":[{"title":"Ktorým API produktov mám začať?","description":"Začnite používateľom a zmenou stavu. Vložené komunity sú určené pre nákupné cesty klubov a komunít, dodávateľské rozhrania pre schválené dodávateľské procesy, firemná identita pre SSO a SCIM a nástroje asistenta iba pre výslovne autorizované postupy vedené AI."},{"title":"Znamená verejná špecifikácia verejný prístup do produkcie?","description":"Nie. Verejná špecifikácia OpenAPI slúži na objavenie rozhrania, posúdenie architektúry a generovanie klientov. Produkčné prihlasovacie údaje, zápisové operácie, dodávateľské procesy, firemná identita aj vykonávanie akcií asistentom môžu stále vyžadovať schválený pracovný priestor a obmedzenú autorizáciu."},{"title":"Môže integrácia odhaliť dodávateľov alebo obísť schvaľovanie?","description":"Nie. Identita a kontakty dodávateľov zostávajú súkromné okrem prípadov povinného zverejnenia. Vzťah s kupujúcim spravuje MerchandAise a operácie ovplyvňujúce objednávku musia zachovať nastavené požiadavky na digitálny náhľad, technické kontroly a vzorky pre konkrétnu objednávku."}]},{"heading":"Naplánujte si integráciu s nami.","paragraphs":["Povedzte nám, kto bude integráciu používať, ktoré údaje potrebuje čítať alebo meniť a kde bude fungovať. Spoločne navrhneme rozhranie, model prístupu a bezpečný postup 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":"route-owned-source","schema":"2025-11-05"}}