{"pageKey":"Developers","slug":"developers-api-integrations","locale":"cs","localeResolved":"cs","fallbackApplied":false,"version":"developers-api-integrations@2026-11-21T00:04:35.725Z","lastModified":null,"canonicalUrl":"https://www.merchandaise.com/cs/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"Produktová API: dokumentace a integrace OpenAPI | MerchandAise","description":"Prohlédněte dokumentaci API a specifikace OpenAPI MerchandAise pro vlastní produkty, komunitní vložení, práci dodavatelů a firemní identity.","sections":[{"heading":"Vyberte propojení, které projekt potřebuje","paragraphs":["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."]},{"heading":"API a integrační rozhraní","items":[{"title":"Dokumentace API a OpenAPI","description":"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."},{"title":"Komunitní API","description":"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."},{"title":"Dodavatelské API","description":"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."},{"title":"API firemních identit","description":"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."}]},{"heading":"Vyberte rozhraní před psaním kódu","items":[{"title":"Krok 1: Zmapujte cestu uživatele","description":"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."},{"title":"Krok 2: Potvrďte hranice přístupu","description":"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."},{"title":"Krok 3: Ověřte návaznost stavu","description":"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."}]},{"heading":"Co musí každá integrace zachovat","items":[{"title":"Jeden verzovaný stav","description":"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í."},{"title":"Obchodní a dodavatelské soukromí","description":"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."},{"title":"Schválení před výrobou","description":"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é."}]},{"heading":"Před produkčním provozem","paragraphs":["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."],"items":[{"title":"Přístup a prostředí","description":"Potvrďte verzi rozhraní, schválený prostor, rozsahy autentizace, testovací prostředí, produkční přihlašovací údaje a cíle callbacků."},{"title":"Selhání a obnovení","description":"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."},{"title":"Doložení celého postupu","description":"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ě."}]},{"heading":"Časté dotazy","items":[{"title":"Kterým produktovým API mám začít?","description":"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."},{"title":"Znamená veřejné rozhraní veřejný produkční přístup?","description":"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."},{"title":"Může integrace zveřejnit dodavatele nebo obejít schválení?","description":"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."}]},{"heading":"Naplánujte integraci s námi.","paragraphs":["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í."],"items":[{"title":"Naplánovat integraci","description":"/cs/contact?intent=api-integration-review"},{"title":"Prohlédnout AI agenty a MCP","description":"/cs/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"route-owned-source","schema":"2025-11-05"}}