{"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.","Where MerchandAise processes the buyer transaction, Hutter Products GmbH is the contracting seller and Merchant of Record under the MerchandAise brand. Supplier identity and contact details stay private except where disclosure is required, and production still requires digital-proof approval, confirmed producibility, mandatory technical checks, and the sample approvals applicable to the exact accepted order."]},{"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). Přístup: Veřejný. 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). Přístup: Veřejný. 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). Přístup: Veřejný. 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). Přístup: Chráněný. 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":"A 3D view is not physical evidence. The confirmed quote explains any available customer-sample choices, costs, limitations, and timing. Approve the exact digital proof and complete mandatory technical checks and any required or selected sample approval before mass production. Existing accepted-order requirements remain binding."}]},{"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":"No. Supplier identity and contact details remain private except where disclosure is required, MerchandAise owns the buyer relationship, and order-affecting actions must preserve the configured digital-proof, technical, and order-specific sample approval requirements."}]},{"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"}}