MerchandAises utvecklarplattform
Koppla arbetsflödet till MerchandAise.
Hitta API-dokumentation och OpenAPI-specifikationer för anpassade produktflöden. Koppla webbplatser, communities, leverantörsarbete eller företagskonton till gemensam design-, offert- och beställningsinformation.
Välj kopplingen som projektet behöver
Använd referenserna nedan för att bedöma ändpunkter, anropsformat och behörighetskrav. Offentliga specifikationer stödjer planering och klientgenerering. Operativ åtkomst beror på API, konto och miljö.
När MerchandAise hanterar köpartransaktionen är Hutter Products GmbH avtalssäljare och Merchant of Record under varumärket MerchandAise. Leverantörsidentitet och kontaktuppgifter förblir privata utom när utlämning krävs. Produktion kräver fortsatt godkänt digitalt korrektur, bekräftad tillverkningsbarhet, obligatoriska tekniska kontroller och de provgodkännanden som gäller för den exakta accepterade beställningen.
01 — Kontrakt
API- och integrationsytor
01
API-dokumentation och OpenAPI
Hitta API-referensen för assistentverktyg och designsessioner och välj sedan community-, leverantörs- eller företagskontrakt för arbetsflödet.
Implementationsguide
Läs dokumentationen för assistentverktygMaskinkontrakt
OpenAPI-JSON för assistentverktyg/api/docs/openapi.jsonOffentlig referens för assistent- och verktygs-API:er. Produktionsåtkomst och beställningspåverkande åtgärder kräver fortfarande tillämplig behörighet.
02
Community-API
Koppla en förenings- eller communitywebbplats till offentlig communityinformation, designbidrag, omröstningar och överlämning för beställningsgodkännande.
- Vad kontraktet omfattar
- Offentligt communitysammanhang, designinlägg och röster, publicering av annonser, väntande beställningar samt godkännande eller avslag från communityägaren.
- En praktisk utgångspunkt
- Läs offentligt communitysammanhang för en föreningswebbplats. Kartlägg sedan vilka åtgärder som kräver medlemssession eller ägarbehörighet innan designbidrag eller övergångar till kassan läggs till.
- Åtkomst
- Specifikationen är offentlig. Offentlig läsning, medlemsåtgärder och ägaråtgärder har olika behörighetskrav. Använd säkerhetsreglerna för varje ändpunkt.
Maskinkontrakt
OpenAPI-JSON för community/api/v1/community/public/openapi/v1Offentligt versionshanterat kontrakt för inbäddade butiker, communitysökning och språkanpassade övergångar.
03
Leverantörs-API
Koppla godkända leverantörssystem till frisläppta produktionspaket, anslutningsstatus och webhookflöden för ERP eller PLM.
- Vad kontraktet omfattar
- Leverantörsanslutningens status, frisläppta produktionspaket, spårbara filnedladdningar, analys, webhookprenumerationer och synkroniseringspunkter.
- En praktisk utgångspunkt
- Planera en koppling mellan ert ERP- eller produktlivscykelsystem och leverantörscentret. Granska webhookinnehåll, återförsök och synkroniseringsstatus innan en tilldelad beställning hanteras.
- Åtkomst
- Läs OpenAPI-specifikationen utan inloggning. Operativa anrop kräver rätt leverantörskonto och behörigheter. Offentlig dokumentation ansluter inte en leverantör och ger inte åtkomst till andra leverantörers data.
Maskinkontrakt
OpenAPI-JSON för leverantörer/api/v1/supplier/openapi/v1Offentligt kontrakt för planering och klientgenerering. Operativ leverantörsåtkomst kräver fortsatt behörighet.
04
API för företagsidentitet
Koppla godkända företagsarbetsytor till enkel inloggning, etablering av användare och grupper samt granskningsloggar för identitet.
- Vad kontraktet omfattar
- Enkel inloggning med OpenID Connect (OIDC), SCIM-livscykelåtgärder för användare och grupper, rotation av SCIM-token och granskningshändelser för etablering.
- En praktisk utgångspunkt
- Koppla identitetsleverantören till den godkända arbetsytan. Planera inloggning, etablering och avveckling av användare och verifiera sedan gruppmappning och granskningsloggar i överenskommen testmiljö.
- Åtkomst
- Specifikationen för företagsidentitet är skyddad. Kontakta integrationsteamet för att granska arbetsyta och åtkomstkrav före implementation. Företagsidentitet är valfritt vid vanliga produktköp.
Maskinkontrakt
OpenAPI-JSON för företagsidentitet/api/v1/enterprise/identity/openapi/v1Skyddat kontrakt för godkända företagsarbetsytor. Begär åtkomst innan ändpunkten används.
Planera en integration02 — Implementationsguide
Välj kontraktet före koden
- 01
Kartlägg användarresan
Bestäm vem som använder arbetsflödet och var: en köpare i en inbäddad butik, en godkänd leverantör, en företagsanvändare eller en assistent med uttrycklig behörighet.
- 02
Bekräfta åtkomstgränsen
Använd offentliga kontrakt för bedömning och klientgenerering. Bekräfta sedan autentiseringsuppgifter, behörighetsomfattningar, miljöer, callbacks och skyddade ändpunkter före implementation.
- 03
Verifiera att tillståndet följer med
Testa att designer, offerter, godkännanden, fel och beställningsövergångar behåller aktuell version genom integrationen, inklusive återförsök och återställningsvägar.
03 — Vad varje integration måste bevara
Vad varje integration måste bevara
Ett versionshanterat tillstånd
Design, köpavsikt, leverantörsbekräftad offert, godkännande och beställningsstatus förblir sammankopplade. Inaktuella ändringar måste leda till en synlig ny offert eller granskning.
Affärs- och leverantörssekretess
MerchandAise förblir köparens säljare och supportansvarig. Leverantörsidentiteter, kontakter och interna data visas inte genom offentliga integrationer.
Godkännande före produktion
En 3D-vy är inget fysiskt belägg. Den bekräftade offerten beskriver tillgängliga kundprov, kostnader, begränsningar och tidsplan. Godkänn det exakta digitala korrekturet och slutför obligatoriska tekniska kontroller samt godkännande av alla obligatoriska eller valda prov före serieproduktion. Befintliga krav för accepterade beställningar fortsätter att gälla.
04
Före produktionstrafik
En publicerad OpenAPI-fil är en planeringsyta, inte ett löfte om anonym produktionsåtkomst. Vi granskar miljöer, autentiseringsuppgifter, felhantering och operativt ansvar före driftsättning.
Åtkomst och miljöer
Bekräfta kontraktsversion, godkänd arbetsyta, behörighetsomfattningar, testmiljö, produktionsuppgifter och callbackdestinationer.
Fel och återhämtning
Definiera återförsök, idempotens, tidsgränser, kundsynliga fel, övervakning, supportansvar och återställning före release.
Underlag för hela flödet
Verifiera den avsedda resan i testmiljön från ingång och tillståndsändring till offert, godkännande, överlämning och återhämtning.
Vanliga frågor
Vilket produkt-API ska jag börja med?
Börja med personen och tillståndsövergången. Använd inbäddad community för köparflöden i föreningar och communities, leverantörsarbete för godkända leverantörsflöden, företagsidentitet för SSO och SCIM och assistentverktyg endast för uttryckligen behöriga AI-ledda flöden.
Innebär ett offentligt kontrakt offentlig produktionsåtkomst?
Nej. Ett offentligt OpenAPI-kontrakt stödjer upptäckt, arkitekturgranskning och klientgenerering. Produktionsuppgifter, skrivåtgärder, leverantörsflöden, företagsidentitet och assistentkörning kan fortfarande kräva en godkänd arbetsyta och avgränsad behörighet.
Kan en integration visa leverantörer eller kringgå godkännanden?
Nej. Leverantörsidentitet och kontaktuppgifter förblir privata utom när utlämning krävs. MerchandAise ansvarar för köparrelationen, och beställningspåverkande åtgärder måste bevara konfigurerade krav på digitalt korrektur, teknik och beställningsspecifika provgodkännanden.
Planera integrationen med oss.
Berätta vem som ska använda integrationen, vilket tillstånd de behöver läsa eller ändra och var upplevelsen ska finnas. Vi kartlägger kontrakt, åtkomstmodell och en säker införandeväg med er.