# Dokumentácia API a integrácie OpenAPI | MerchandAise

- slug: developers-api-integrations
- locale: sk
- localeResolved: sk
- canonical: https://www.merchandaise.com/sk/developers/api-integrations

Preskúmajte API a OpenAPI MerchandAise pre produkty s vlastným dizajnom, vložené komunity, dodávateľské procesy a firemnú identitu.

## Vyberte prepojenie podľa potrieb svojho projektu
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.

## API a integračné rozhrania
- **Dokumentácia API a OpenAPI:** 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.
- **Komunitné API:** 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.
- **API dodávateľov:** 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.
- **API firemnej identity:** 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.

## Najprv vyberte rozhranie, potom píšte kód
- **Krok 1: Zmapujte cestu používateľa:** 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.
- **Krok 2: Potvrďte hranice prístupu:** 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.
- **Krok 3: Overte nadväznosť stavov:** 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.

## Čo musí každá integrácia zachovať
- **Jeden verziovaný stav:** 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.
- **Ochrana obchodných a dodávateľských údajov:** 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.
- **Schválenie pred výrobou:** 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é.

## Pred spustením produkčnej prevádzky
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ť.
- **Prístup a prostredia:** Potvrďte verziu rozhrania, schválený pracovný priestor, autentifikačné oprávnenia, testovacie prostredie, produkčné prihlasovacie údaje a adresy spätných volaní.
- **Chyby a obnova:** 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.
- **Dôkazy z celého procesu:** V testovacom prostredí overte plánovanú cestu od vstupu a zmeny stavu cez ponuku a schválenie až po odovzdanie a zotavenie po chybe.

## Časté otázky
- **Ktorým API produktov mám začať?:** 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.
- **Znamená verejná špecifikácia verejný prístup do produkcie?:** 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.
- **Môže integrácia odhaliť dodávateľov alebo obísť schvaľovanie?:** 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.

## Naplánujte si integráciu s nami.
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.
- **Naplánovať integráciu:** /sk/contact?intent=api-integration-review
- **Preskúmať AI agentov a MCP:** /sk/developers/ai-agents-mcp
