# Merchandise API a integračné kontrakty | MerchandAise

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

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.

## Udržujte jediný zdroj pravdy
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.

## API a integračné rozhrania
- **Dokumentácia API pre nástroje asistentov:** 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.
- **API pre komunitné integrácie:** 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.
- **Dodávateľské API:** 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.
- **API pre podnikovú identitu:** 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.

## Vyberte si kontrakt ešte pred písaním kódu
- **Step 1: Zmapujte cestu používateľa:** 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.
- **Step 2: Potvrďte hranice prístupu:** 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.
- **Step 3: Preukážte kontinuitu stavu:** 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).

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

## Pred spustením produkčnej prevádzky
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ť.
- **Prístup a prostredia:** Potvrďte verziu kontraktu, schválený pracovný priestor, rozsahy overenia (scopes), sandbox, produkčné prihlasovacie údaje a cieľové adresy pre spätné volania.
- **Chyby a obnova:** 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).
- **Kompletné overenie (End-to-end):** 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.

## Často kladené otázky
- **S ktorým integračným rozhraním by som mal začať?:** 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.
- **Znamená verejný kontrakt aj verejný prístup do produkcie?:** 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.
- **Môže integrácia odhaliť dodávateľov alebo obísť schvaľovanie?:** 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.

## Predstavte nám svoj proces, nie hotovú architektúru.
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.
- **Naplánovať integráciu:** /sk/contact?intent=api-integration-review
- **Preskúmať AI agentov a MCP:** /sk/developers/ai-agents-mcp