# Merchandise API a integrační kontrakty | MerchandAise

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

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.

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

## API a integrační rozhraní
- **Dokumentace k nástrojům asistenta API:** 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.
- **Komunitní embed API:** 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.
- **Dodavatelské API:** 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.
- **Podniková identita API:** 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.

## Zvolte smlouvu před kódem
- **Step 1: Namapujte cestu uživatele:** 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.
- **Step 2: Potvrďte hranici přístupu:** 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.
- **Step 3: Prokažte kontinuitu stavu:** 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.

## Co musí každá integrace zachovat
- **Jeden verzovaný stav:** 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í.
- **Obchodní a dodavatelské soukromí:** 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.
- **Schválení před výrobou:** 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.

## Před produkčním provozem
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.
- **Přístup a prostředí:** Potvrďte verzi smlouvy, schválené pracovní prostředí, autentizační rozsahy, sandbox, produkční pověření a cíle callbacků.
- **Selhání a zotavení:** Definujte opakování, idempotenci, timeouty, chyby viditelné zákazníkovi, pozorovatelnost, odpovědnost podpory a rollback před uvolněním.
- **Důkazy end-to-end:** 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í.

## FAQ
- **S kterou integrační plochou mám začít?:** 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.
- **Znamená veřejná smlouva veřejný přístup do produkce?:** 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.
- **Může integrace vystavit dodavatele nebo obejít schválení?:** 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.

## Přineste nám workflow, ne hotovou architekturu.
Ř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í.
- **Naplánovat integraci:** /cs/contact?intent=api-integration-review
- **Prozkoumat AI agenty a MCP:** /cs/developers/ai-agents-mcp