Vývojářská platforma MerchandAise
Propojte svůj postup s MerchandAise.
Najděte dokumentaci API a specifikace OpenAPI pro produkty s vlastním designem. Propojte weby, komunity, dodavatelské operace nebo firemní účty se společnými údaji o návrhu, nabídce a objednávce.
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.
01 — Rozhraní
API a integrační rozhraní
01
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ůStrojově čitelné rozhraní
OpenAPI JSON pro nástroje asistentů/api/docs/openapi.jsonVeř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.
02
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.
Strojově čitelné rozhraní
Komunitní OpenAPI JSON/api/v1/community/public/openapi/v1Veřejné verzované rozhraní pro vložené obchody, vyhledávání komunit a přechody zachovávající jazyk.
03
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.
Strojově čitelné rozhraní
Dodavatelské OpenAPI JSON/api/v1/supplier/openapi/v1Veřejné rozhraní pro plánování a generování klientů. Provozní přístup dodavatelů zůstává podmíněn oprávněním.
04
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á.
Strojově čitelné rozhraní
OpenAPI JSON firemních identit/api/v1/enterprise/identity/openapi/v1Chráněné rozhraní pro schválené firemní prostory; před použitím endpointu požádejte o přístup.
Naplánovat integraci02 — Průvodce implementací
Vyberte rozhraní před psaním kódu
- 01
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.
- 02
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.
- 03
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.
03 — Co musí každá integrace zachovat
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é.
04
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í.