Přeskočit na hlavní obsah

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.

Přístup: Veřejné

Strojově čitelné rozhraní

OpenAPI JSON pro nástroje asistentů
/api/docs/openapi.json

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.

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.
Přístup: Veřejné

Strojově čitelné rozhraní

Komunitní OpenAPI JSON
/api/v1/community/public/openapi/v1

Veř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.
Přístup: Veřejné

Strojově čitelné rozhraní

Dodavatelské OpenAPI JSON
/api/v1/supplier/openapi/v1

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.

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á.
Přístup: Chráněné

Strojově čitelné rozhraní

OpenAPI JSON firemních identit
/api/v1/enterprise/identity/openapi/v1

Chráněné rozhraní pro schválené firemní prostory; před použitím endpointu požádejte o přístup.

Naplánovat integraci

02 — Průvodce implementací

Vyberte rozhraní před psaním kódu

  1. 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.

  2. 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.

  3. 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.

01

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ů.

02

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.

03

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í.