Platforma MerchandAise pre vývojárov
Prepojte svoje procesy s MerchandAise.
Nájdite dokumentáciu API a špecifikácie OpenAPI pre produkty s vlastným dizajnom. Prepojte web, komunitu, dodávateľské procesy alebo firemné účty so spoločnými údajmi o dizajne, ponuke a objednávke.
Vyberte prepojenie podľa potrieb svojho projektu
Pomocou odkazov nižšie posúďte koncové body, formáty požiadaviek a požiadavky na autorizáciu. Verejné špecifikácie slúžia na plánovanie a generovanie klientov; prevádzkový prístup závisí od API, účtu a prostredia.
Ak MerchandAise spracúva nákupnú transakciu, zmluvným predávajúcim a obchodníkom zodpovedným za transakciu pod značkou MerchandAise je Hutter Products GmbH. Identita a kontakty dodávateľov zostávajú súkromné, okrem prípadov povinného zverejnenia. Výroba naďalej vyžaduje schválenie digitálneho náhľadu, potvrdenie vyrobiteľnosti, povinné technické kontroly a schválenie vzoriek podľa presných podmienok prijatej objednávky.
01 — Špecifikácie
API a integračné rozhrania
01
Dokumentácia API a OpenAPI
Nájdite referenciu API pre nástroje asistenta a relácie navrhovania. Potom vyberte komunitné, dodávateľské alebo firemné rozhranie pre svoj postup.
Sprievodca implementáciou
Otvoriť dokumentáciu nástrojov asistentaStrojovo čitateľná špecifikácia
OpenAPI JSON nástrojov asistenta/api/docs/openapi.jsonVerejná referencia pre API asistenta a nástrojov. Produkčný prístup a operácie ovplyvňujúce objednávky naďalej vyžadujú príslušnú autorizáciu.
02
Komunitné API
Prepojte web klubu alebo komunity s verejnými informáciami o komunite, návrhmi dizajnov, hlasovaním a odovzdaním objednávky na schválenie.
- Čo rozhranie pokrýva
- Verejný kontext komunity, dizajnové príspevky a hlasy, zverejnenie ponúk, čakajúce objednávky a ich schválenie alebo zamietnutie vlastníkom komunity.
- Praktický prvý krok
- Načítajte verejné údaje komunity pre klubový web. Pred pridaním návrhov dizajnov alebo prechodu k objednávke určte, ktoré akcie vyžadujú reláciu člena alebo oprávnenia vlastníka.
- Prístup
- Špecifikácia je verejná. Verejné čítanie, akcie členov a operácie vyhradené vlastníkovi majú odlišné požiadavky na autorizáciu; riaďte sa bezpečnostnými pravidlami každého koncového bodu.
Strojovo čitateľná špecifikácia
OpenAPI JSON komunity/api/v1/community/public/openapi/v1Verejná verziovaná špecifikácia pre vložené predajne, objavovanie komunít a odovzdanie s príslušným jazykom.
03
API dodávateľov
Prepojte systémy schválených dodávateľov s uvoľnenými výrobnými balíkmi, stavom registrácie a webhookmi ERP alebo PLM.
- Čo rozhranie pokrýva
- Stav registrácie dodávateľa, uvoľnené výrobné balíky, auditované sťahovanie podkladov, analytiku, odbery webhookov a kontrolné body synchronizácie.
- Praktický prvý krok
- Naplánujte prepojenie systému ERP alebo správy životného cyklu produktov s dodávateľským centrom. Pred spracovaním pridelenej objednávky skontrolujte dáta webhookov, opakovanie požiadaviek a stav synchronizácie.
- Prístup
- Špecifikáciu OpenAPI si môžete prečítať bez prihlásenia. Prevádzkové požiadavky vyžadujú príslušný dodávateľský účet a oprávnenia. Verejná dokumentácia dodávateľa neregistruje ani neposkytuje prístup k údajom iného dodávateľa.
Strojovo čitateľná špecifikácia
OpenAPI JSON dodávateľov/api/v1/supplier/openapi/v1Verejná špecifikácia na plánovanie a generovanie klientov. Prevádzkový prístup dodávateľa zostáva viazaný na oprávnenia.
04
API firemnej identity
Prepojte schválené firemné pracovné priestory s jednotným prihlásením, správou používateľov a skupín a auditnými záznamami identity.
- Čo rozhranie pokrýva
- Jednotné prihlásenie OpenID Connect (OIDC), operácie životného cyklu používateľov a skupín SCIM, rotáciu tokenov SCIM a auditné udalosti správy účtov.
- Praktický prvý krok
- Prepojte svojho poskytovateľa identity so schváleným pracovným priestorom. Naplánujte prihlasovanie, vytváranie a rušenie účtov a potom overte mapovanie skupín a auditné záznamy v dohodnutom testovacom prostredí.
- Prístup
- Špecifikácia firemnej identity je chránená. Pred implementáciou preberte pracovný priestor a požiadavky na prístup s integračným tímom. Firemná identita nie je povinná pri bežnom nákupe produktov.
Strojovo čitateľná špecifikácia
OpenAPI JSON firemnej identity/api/v1/enterprise/identity/openapi/v1Chránená špecifikácia pre schválené firemné pracovné priestory. Pred použitím tohto koncového bodu požiadajte o prístup.
Naplánovať integráciu02 — Sprievodca implementáciou
Najprv vyberte rozhranie, potom píšte kód
- 01
Zmapujte cestu používateľa
Určte, kto a kde vstupuje do procesu: kupujúci vo vloženej predajni, schválený dodávateľ, firemný používateľ alebo asistent s výslovnou autorizáciou.
- 02
Potvrďte hranice prístupu
Verejné špecifikácie použite na posúdenie a generovanie klientov. Pred implementáciou potvrďte prihlasovacie údaje, rozsahy oprávnení, prostredia, spätné volania a chránené koncové body.
- 03
Overte nadväznosť stavov
Otestujte, že dizajny, ponuky, schválenia, chyby a odovzdania objednávok zachovávajú aktuálnu verziu naprieč integráciou vrátane opakovaných požiadaviek a návratu k predchádzajúcemu stavu.
03 — Čo musí každá integrácia zachovať
Čo musí každá integrácia zachovať
Jeden verziovaný stav
Dizajn, nákupný zámer, ponuka potvrdená dodávateľom, schválenie a stav objednávky zostávajú prepojené. Zastarané zmeny musia vyvolať viditeľné opätovné nacenenie alebo kontrolu.
Ochrana obchodných a dodávateľských údajov
MerchandAise zostáva obchodníkom a kontaktným miestom podpory pre kupujúceho. Verejné integrácie nezverejňujú identitu, kontakty ani interné údaje dodávateľov.
Schválenie pred výrobou
3D náhľad nie je fyzický dôkaz. Potvrdená ponuka vysvetľuje dostupné možnosti zákazníckych vzoriek, náklady, obmedzenia a termíny. Pred sériovou výrobou schváľte presný digitálny náhľad, dokončite povinné technické kontroly a schváľte požadované alebo zvolené vzorky. Požiadavky už prijatých objednávok zostávajú záväzné.
04
Pred spustením produkčnej prevádzky
Zverejnený súbor OpenAPI slúži na plánovanie; nesľubuje anonymný prístup do produkcie. Pred spustením preverujeme prostredia, prihlasovacie údaje, riešenie chýb a prevádzkovú zodpovednosť.
Prístup a prostredia
Potvrďte verziu rozhrania, schválený pracovný priestor, autentifikačné oprávnenia, testovacie prostredie, produkčné prihlasovacie údaje a adresy spätných volaní.
Chyby a obnova
Pred vydaním určte opakovanie požiadaviek, idempotentnosť, časové limity, chyby viditeľné zákazníkovi, sledovanie prevádzky, zodpovednosť podpory a návrat k predchádzajúcej verzii.
Dôkazy z celého procesu
V testovacom prostredí overte plánovanú cestu od vstupu a zmeny stavu cez ponuku a schválenie až po odovzdanie a zotavenie po chybe.
Časté otázky
Ktorým API produktov mám začať?
Začnite používateľom a zmenou stavu. Vložené komunity sú určené pre nákupné cesty klubov a komunít, dodávateľské rozhrania pre schválené dodávateľské procesy, firemná identita pre SSO a SCIM a nástroje asistenta iba pre výslovne autorizované postupy vedené AI.
Znamená verejná špecifikácia verejný prístup do produkcie?
Nie. Verejná špecifikácia OpenAPI slúži na objavenie rozhrania, posúdenie architektúry a generovanie klientov. Produkčné prihlasovacie údaje, zápisové operácie, dodávateľské procesy, firemná identita aj vykonávanie akcií asistentom môžu stále vyžadovať schválený pracovný priestor a obmedzenú autorizáciu.
Môže integrácia odhaliť dodávateľov alebo obísť schvaľovanie?
Nie. Identita a kontakty dodávateľov zostávajú súkromné okrem prípadov povinného zverejnenia. Vzťah s kupujúcim spravuje MerchandAise a operácie ovplyvňujúce objednávku musia zachovať nastavené požiadavky na digitálny náhľad, technické kontroly a vzorky pre konkrétnu objednávku.
Naplánujte si integráciu s nami.
Povedzte nám, kto bude integráciu používať, ktoré údaje potrebuje čítať alebo meniť a kde bude fungovať. Spoločne navrhneme rozhranie, model prístupu a bezpečný postup nasadenia.