Preskočiť na hlavný obsah

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.

Prístup: Verejný

Strojovo čitateľná špecifikácia

OpenAPI JSON nástrojov asistenta
/api/docs/openapi.json

Verejná 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.
Prístup: Verejný

Strojovo čitateľná špecifikácia

OpenAPI JSON komunity
/api/v1/community/public/openapi/v1

Verejná 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.
Prístup: Verejný

Strojovo čitateľná špecifikácia

OpenAPI JSON dodávateľov
/api/v1/supplier/openapi/v1

Verejná š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.
Prístup: Chránený

Strojovo čitateľná špecifikácia

OpenAPI JSON firemnej identity
/api/v1/enterprise/identity/openapi/v1

Chrá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áciu

02 — Sprievodca implementáciou

Najprv vyberte rozhranie, potom píšte kód

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

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

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

01

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

02

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.

03

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.