{"pageKey":"Developers","slug":"developers-api-integrations","locale":"cs","localeResolved":"cs","fallbackApplied":false,"version":"developers-api-integrations@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/cs/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"Merchandise API a integrační kontrakty | MerchandAise","description":"Prozkoumejte kontrakty MerchandAise pro asistenční nástroje, komunitní integrace, dodavatelské operace a firemní identitu s jasně vymezenými hranicemi veřejného a chráněného přístupu.","sections":[{"heading":"Udržujte jeden zdroj pravdy","paragraphs":["Integrace by měla rozšiřovat workflow MerchandAise, nikoli ho rozdvojovat. Webové stránky, vložené prvky, dodavatelské rozhraní, podniková identita i budoucí asistenti musí číst a aktualizovat stejný verzovaný návrh, obchodní záměr, nabídku, schválení a stav objednávky.","Kde MerchandAise zpracovává transakci kupujícího, je Hutter Products GmbH smluvním prodejcem a Merchant of Record pod značkou MerchandAise. Identita a kontaktní údaje dodavatelů zůstávají soukromé kromě případů, kdy vyžaduje zveřejnění zákon nebo jiné povinnosti, a do výroby je stále vyžadováno schválení digitálního důkazu a skutečného vzorku."]},{"heading":"API a integrační rozhraní","items":[{"title":"Dokumentace k nástrojům asistenta API","description":"Prozkoumejte aktuální koncové body asistenta a nástrojů pro návrhářská sezení a revizi integrace. Tato veřejná reference neopravňuje anonymní uživatele k vytváření cenových nabídek ani k zadávání objednávek. Human guide: Otevřít dokumentaci k nástrojům asistenta (/cs/developers/api-integrations). Machine-readable contract: Nástroje asistenta OpenAPI JSON (/api/docs/openapi.json). Access: public. Veřejná reference pro API asistenta a nástrojů. Přístup do produkčního prostředí a operace ovlivňující objednávky stále vyžadují příslušné oprávnění. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs."},{"title":"Komunitní embed API","description":"Propojte lokalizované kluby, komunity nebo e-shopy s procesy návrhu a prodeje platformy MerchandAise, aniž byste museli znovu vytvářet základní workflow. Human guide: Zobrazit průvodce komunitní integrací (/cs/developers/api-integrations#community-integrations). Machine-readable contract: Komunitní OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. Veřejný verzovaný kontrakt pro e-shopové embedy, objevování komunit a předávání dat s ohledem na lokalizaci. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations."},{"title":"Dodavatelské API","description":"Propojte schválené dodavatele s procesy onboardingu, katalogu, cenových nabídek a vyřizování objednávek po ověření dodavatelského vztahu a přístupového modelu. Human guide: Zobrazit průvodce integrací dodavatele (/cs/developers/api-integrations#supplier-integrations). Machine-readable contract: Dodavatelské OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. Veřejný kontrakt pro plánování a generování klientů. Operativní přístup dodavatele zůstává podmíněn oprávněním. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations."},{"title":"Podniková identita API","description":"Plánujte SSO, zřizování SCIM a toky identit připravené na audit pro schválené firemní programy reklamních předmětů a řízené nasazení. Human guide: Zobrazit průvodce podnikovou integrací (/cs/developers/api-integrations#enterprise-integrations). Machine-readable contract: Podniková identita OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. Chráněný kontrakt pro schválené podnikové pracovní prostory; před použitím tohoto koncového bodu požádejte o přístup. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations."}]},{"heading":"Zvolte smlouvu před kódem","items":[{"title":"Step 1: Namapujte cestu uživatele","description":"Rozhodněte, kdo vstupuje do workflow a kde: kupující ve vloženém obchodě, schválený dodavatel, podnikový uživatel nebo asistent s explicitním oprávněním."},{"title":"Step 2: Potvrďte hranici přístupu","description":"Použijte veřejné smlouvy pro hodnocení a generování klientů, poté před implementací potvrďte pověření, rozsahy, prostředí, callbacky a chráněné koncové body."},{"title":"Step 3: Prokažte kontinuitu stavu","description":"Otestujte, že návrhy, nabídky, schválení, chyby a předání objednávek zůstávají aktuální vůči verzi napříč integrací, včetně opakování a rollback cest."}]},{"heading":"Co musí každá integrace zachovat","items":[{"title":"Jeden verzovaný stav","description":"Návrh, obchodní záměr, nabídka podložená dodavatelem, schválení a stav objednávky zůstávají propojené. Zastaralé změny musí vyvolat viditelný přepočet nabídky nebo stav k přezkoumání."},{"title":"Obchodní a dodavatelské soukromí","description":"MerchandAise zůstává obchodním a podpůrným kontaktem směrem k zákazníkovi. Identita dodavatele, kontakty a interní data nejsou přes veřejné integrace vystavena."},{"title":"Schválení před výrobou","description":"Produktově nativní 3D náhled a digitální důkaz podporují rozhodnutí, ale nenahrazují skutečný výrobní vzorek požadovaný před hromadnou výrobou."}]},{"heading":"Před produkčním provozem","paragraphs":["Publikovaný OpenAPI soubor slouží pro plánování, nikoli jako záruka anonymního přístupu do produkce. Před spuštěním přezkoumáme prostředí, pověření, zpracování chyb a provozní zodpovědnost."],"items":[{"title":"Přístup a prostředí","description":"Potvrďte verzi smlouvy, schválené pracovní prostředí, autentizační rozsahy, sandbox, produkční pověření a cíle callbacků."},{"title":"Selhání a zotavení","description":"Definujte opakování, idempotenci, timeouty, chyby viditelné zákazníkovi, pozorovatelnost, odpovědnost podpory a rollback před uvolněním."},{"title":"Důkazy end-to-end","description":"Ověřte zamýšlenou cestu ve stagingu od vstupu a změny stavu přes nabídku, schválení, předání a chování při zotavení."}]},{"heading":"FAQ","items":[{"title":"S kterou integrační plochou mám začít?","description":"Začněte u osoby a přechodu stavu. Použijte komunitní vložení pro zákaznicky orientované cesty klubu nebo komunity, dodavatelské operace pro schválené workflow na straně dodavatele, enterprise identity pro SSO a SCIM a nástroje asistenta pouze pro explicitně autorizované AI řízené toky."},{"title":"Znamená veřejná smlouva veřejný přístup do produkce?","description":"Ne. Veřejná OpenAPI smlouva slouží pro objevování, přezkum architektury a generování klientů. Produkční pověření, zápisové operace, dodavatelská workflow, podniková identita a provádění asistenta mohou stále vyžadovat schválené pracovní prostředí a omezenou autorizaci."},{"title":"Může integrace vystavit dodavatele nebo obejít schválení?","description":"Ne. Identita a kontaktní údaje dodavatele zůstávají soukromé kromě případů, kdy vyžaduje zveřejnění zákon nebo jiné povinnosti; MerchandAise vlastní vztah s kupujícím a akce ovlivňující objednávky musí zachovat nakonfigurované brány schválení a požadavek na skutečný vzorek."}]},{"heading":"Přineste nám workflow, ne hotovou architekturu.","paragraphs":["Řekněte nám, kdo bude integraci používat, jaký stav musí číst nebo měnit a kde bude zážitek umístěn. S vámi namapujeme smlouvu, model přístupu a nejbezpečnější postup zavedení."],"items":[{"title":"Naplánovat integraci","description":"/cs/contact?intent=api-integration-review"},{"title":"Prozkoumat AI agenty a MCP","description":"/cs/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}