# Produktová API: dokumentace a integrace OpenAPI | MerchandAise

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

Prohlédněte dokumentaci API a specifikace OpenAPI MerchandAise pro vlastní produkty, komunitní vložení, práci dodavatelů a firemní identity.

## Vyberte propojení, které projekt potřebuje
Pomocí níže uvedených referencí posuďte endpointy, formáty požadavků a autorizační podmínky. Veřejné specifikace podporují plánování a generování klientů; provozní přístup závisí na API, účtu a prostředí.
Při zpracování nákupu přes MerchandAise je Hutter Products GmbH smluvním prodávajícím a Merchant of Record pod značkou MerchandAise. Totožnost a kontakty dodavatelů zůstávají neveřejné s výjimkou požadovaného zveřejnění. Výroba nadále vyžaduje schválení digitálního náhledu, potvrzení vyrobitelnosti, povinné technické kontroly a schválení vzorků platná pro přesnou přijatou objednávku.

## API a integrační rozhraní
- **Dokumentace API a OpenAPI:** Najděte API pro nástroje asistentů a návrhové relace, poté vyberte komunitní, dodavatelské nebo firemní rozhraní podle svého postupu. Průvodce implementací: Číst dokumentaci nástrojů asistentů (/api/docs). Strojově čitelná specifikace: OpenAPI JSON pro nástroje asistentů (/api/docs/openapi.json). Přístup: Veřejné. Veřejná reference pro API asistentů a nástrojů. Produkční přístup a operace ovlivňující objednávky nadále vyžadují příslušnou autorizaci. Kanonická stránka: /cs/developers/api-integrations. Kanonická sekce: /cs/developers/api-integrations#api-docs.
- **Komunitní API:** Propojte klubový nebo komunitní web s veřejnými informacemi o komunitě, přidáváním návrhů, hlasováním a předáváním objednávek ke schválení. Co rozhraní pokrývá: Veřejný kontext komunity, příspěvky s návrhy a hlasy, zveřejňování produktů, čekající objednávky a schválení či zamítnutí vlastníkem komunity. Praktický výchozí bod: Načtěte veřejný kontext komunity pro klubový web. Před přidáním návrhových příspěvků nebo přechodů k objednávce určete, které akce vyžadují relaci člena nebo oprávnění vlastníka. Přístup: Specifikace je veřejná. Veřejná čtení, členské akce a operace vlastníka mají různé autorizační požadavky; dodržujte bezpečnostní pravidla každého endpointu. Průvodce implementací: Prohlédnout komunitní API (/cs/developers/api-integrations#community-integrations). Strojově čitelná specifikace: Komunitní OpenAPI JSON (/api/v1/community/public/openapi/v1). Přístup: Veřejné. Veřejné verzované rozhraní pro vložené obchody, vyhledávání komunit a přechody zachovávající jazyk. Kanonická stránka: /cs/developers/api-integrations. Kanonická sekce: /cs/developers/api-integrations#community-integrations.
- **Dodavatelské API:** Propojte systémy schválených dodavatelů s uvolněnými výrobními podklady, stavem registrace a webhooky ERP či PLM. Co rozhraní pokrývá: Stav registrace dodavatele, uvolněné výrobní podklady, auditované stahování souborů, analytiku, odběry webhooků a kontrolní body synchronizace. Praktický výchozí bod: Naplánujte propojení ERP nebo systému správy životního cyklu produktu s centrem pro dodavatele. Před zpracováním přidělené objednávky projděte data webhooků, opakované pokusy a stav synchronizace. Přístup: Specifikaci OpenAPI můžete číst bez přihlášení. Provozní požadavky vyžadují odpovídající dodavatelský účet a oprávnění; veřejná dokumentace nezaregistruje dodavatele ani nezpřístupní údaje jiného dodavatele. Průvodce implementací: Prohlédnout dodavatelské API (/cs/developers/api-integrations#supplier-integrations). Strojově čitelná specifikace: Dodavatelské OpenAPI JSON (/api/v1/supplier/openapi/v1). Přístup: Veřejné. Veřejné rozhraní pro plánování a generování klientů. Provozní přístup dodavatelů zůstává podmíněn oprávněním. Kanonická stránka: /cs/developers/api-integrations. Kanonická sekce: /cs/developers/api-integrations#supplier-integrations.
- **API firemních identit:** Propojte schválené firemní prostory s jednotným přihlášením, správou uživatelů a skupin a auditními záznamy identit. Co rozhraní pokrývá: Jednotné přihlášení OpenID Connect (OIDC), operace životního cyklu uživatelů a skupin SCIM, rotaci tokenů SCIM a auditní události správy účtů. Praktický výchozí bod: Propojte poskytovatele identity se schváleným prostorem. Naplánujte přihlášení, vytváření a rušení přístupů uživatelů a pak ověřte mapování skupin a auditní záznamy v dohodnutém testovacím prostředí. Přístup: Specifikace firemních identit je chráněná. Před implementací kontaktujte integrační tým pro posouzení prostoru a přístupu. Firemní identita je pro běžné nákupy produktů volitelná. Průvodce implementací: Prohlédnout firemní identity (/cs/developers/api-integrations#enterprise-integrations). Strojově čitelná specifikace: OpenAPI JSON firemních identit (/api/v1/enterprise/identity/openapi/v1). Přístup: Chráněné. Chráněné rozhraní pro schválené firemní prostory; před použitím endpointu požádejte o přístup. Kanonická stránka: /cs/developers/api-integrations. Kanonická sekce: /cs/developers/api-integrations#enterprise-integrations.

## Vyberte rozhraní před psaním kódu
- **Krok 1: Zmapujte cestu uživatele:** Určete, kdo a kde vstupuje do postupu: kupující ve vloženém obchodě, schválený dodavatel, firemní uživatel nebo asistent s výslovným oprávněním.
- **Krok 2: Potvrďte hranice přístupu:** Veřejná rozhraní použijte pro posouzení a generování klientů, potom před implementací potvrďte přihlašovací údaje, rozsahy oprávnění, prostředí, callbacky a chráněné endpointy.
- **Krok 3: Ověřte návaznost stavu:** Otestujte, že návrhy, nabídky, schválení, chyby a předání objednávek zůstávají během integrace aktuální, včetně opakovaných pokusů a návratu k předchozí verzi.

## Co musí každá integrace zachovat
- **Jeden verzovaný stav:** Návrh, nákupní záměr, nabídka podložená dodavatelem, schválení a stav objednávky zůstávají propojené. Zastaralé změny musí vyvolat viditelnou novou nabídku nebo posouzení.
- **Obchodní a dodavatelské soukromí:** MerchandAise zůstává prodávajícím a odpovědným kontaktem pro podporu kupujícího. Totožnost dodavatelů, kontakty a interní údaje nejsou zpřístupněny veřejnými integracemi.
- **Schválení před výrobou:** Náhled 3D není fyzickým důkazem. Potvrzená nabídka vysvětluje případné dostupné možnosti zákaznických vzorků, náklady, omezení a termíny. Před hromadnou výrobou schvalte přesný digitální náhled a dokončete povinné technické kontroly a veškerá požadovaná či zvolená schválení vzorků. Stávající požadavky přijaté objednávky zůstávají závazné.

## Před produkčním provozem
Zveřejněný soubor OpenAPI slouží k plánování, neslibuje anonymní produkční přístup. Před spuštěním posoudíme prostředí, přihlašovací údaje, řešení selhání a provozní odpovědnosti.
- **Přístup a prostředí:** Potvrďte verzi rozhraní, schválený prostor, rozsahy autentizace, testovací prostředí, produkční přihlašovací údaje a cíle callbacků.
- **Selhání a obnovení:** Před vydáním určete opakování, idempotenci, časové limity, chyby viditelné zákazníkům, sledovatelnost, odpovědnost za podporu a návrat k předchozí verzi.
- **Doložení celého postupu:** V testovacím prostředí ověřte zamýšlenou cestu od vstupu a změny stavu přes nabídku, schválení a předání až po obnovení při chybě.

## Časté dotazy
- **Kterým produktovým API mám začít?:** Začněte uživatelem a změnou stavu. Pro klubové či komunitní nákupy použijte komunitní vložení, pro schválené dodavatelské postupy dodavatelské operace, pro SSO a SCIM firemní identity a nástroje asistentů pouze pro výslovně autorizované postupy s AI.
- **Znamená veřejné rozhraní veřejný produkční přístup?:** Ne. Veřejná specifikace OpenAPI umožňuje vyhledávání, posouzení architektury a generování klientů. Produkční přihlašovací údaje, zápisy, dodavatelské postupy, firemní identity a provádění akcí asistentem mohou nadále vyžadovat schválený prostor a vymezenou autorizaci.
- **Může integrace zveřejnit dodavatele nebo obejít schválení?:** Ne. Totožnost a kontakty dodavatelů zůstávají neveřejné s výjimkou povinného zveřejnění. Vztah s kupujícím spravuje MerchandAise a akce ovlivňující objednávky musí zachovat nastavené schvalování digitálního náhledu, technické kontroly a požadavky na vzorky konkrétní objednávky.

## Naplánujte integraci s námi.
Napište, kdo bude integraci používat, který stav potřebuje číst nebo měnit a kde bude služba dostupná. Společně zmapujeme rozhraní, model přístupu a nejbezpečnější postup zavedení.
- **Naplánovat integraci:** /cs/contact?intent=api-integration-review
- **Prohlédnout AI agenty a MCP:** /cs/developers/ai-agents-mcp
