Gå til hovedinnhold

MerchandAises utviklerplattform

Koble arbeidsflyten din til MerchandAise.

Finn API-dokumentasjon og OpenAPI-spesifikasjoner for profilproduktflyter. Koble nettsider, fellesskap, leverandørdrift eller bedriftskontoer til felles informasjon om design, tilbud og bestillinger.

Velg koblingen prosjektet trenger

Bruk referansene nedenfor til å vurdere endepunkter, forespørselsformater og autorisasjonskrav. Offentlige spesifikasjoner støtter planlegging og klientgenerering; operativ tilgang avhenger av API-et, kontoen og miljøet.

Der MerchandAise håndterer kjøpertransaksjonen, er Hutter Products GmbH kontraktsmessig selger og Merchant of Record under MerchandAise-merkevaren. Leverandøridentitet og kontaktopplysninger forblir private med unntak av påkrevd utlevering, og produksjon krever fortsatt digital korrekturgodkjenning, bekreftet produksjonsmulighet, obligatoriske tekniske kontroller og prøvegodkjenninger som gjelder den konkrete aksepterte bestillingen.

01 — Kontrakter

API-er og integrasjonspunkter

01

API-dokumentasjon og OpenAPI

Finn API-referansen for assistentverktøy og designøkter, og velg deretter fellesskaps-, leverandør- eller bedriftskontrakten som passer arbeidsflyten.

Tilgang: Offentlig/api/docs/openapi.json

Offentlig referanse for assistent- og verktøy-API-er. Produksjonstilgang og handlinger som påvirker bestillinger, krever fortsatt relevant autorisasjon.

02

Fellesskaps-API

Koble en klubb- eller fellesskapsnettside til offentlig fellesskapsinformasjon, designinnsendinger, avstemninger og overganger til ordregodkjenning.

Dette dekker kontrakten
Offentlig fellesskapskontekst, designinnlegg og stemmer, publisering av oppføringer, ventende bestillinger og godkjenning eller avvisning fra fellesskapseier.
Et praktisk utgangspunkt
Les offentlig fellesskapskontekst til en klubbnettside. Kartlegg deretter hvilke handlinger som krever medlemsøkt eller eiertillatelse, før designinnsendinger eller overganger til kassen legges til.
Tilgang
Spesifikasjonen er offentlig. Offentlig lesing, medlemshandlinger og eierhandlinger har ulike autorisasjonskrav; bruk sikkerhetsreglene for hvert endepunkt.
Tilgang: Offentlig

Maskinlesbar kontrakt

OpenAPI-JSON for fellesskap
/api/v1/community/public/openapi/v1

Offentlig versjonert kontrakt for innebygde butikker, oppdagelse av fellesskap og språktilpassede overganger.

03

Leverandør-API

Koble godkjente leverandørsystemer til frigitte produksjonspakker, registreringsstatus og ERP- eller PLM-webhookflyter.

Dette dekker kontrakten
Leverandørens registreringsstatus, frigitte produksjonspakker, loggførte filnedlastinger, analyse, webhookabonnementer og synkroniseringspunkter.
Et praktisk utgangspunkt
Planlegg en kobling mellom ERP- eller produktlivssyklussystemet og Leverandørsenteret. Gjennomgå webhookdata, nye forsøk og synkroniseringsstatus før en tildelt bestilling håndteres.
Tilgang
Les OpenAPI-spesifikasjonen uten å logge inn. Operative forespørsler krever riktig leverandørkonto og tillatelser; offentlig dokumentasjon registrerer ikke en leverandør og gir ikke tilgang til andre leverandørers data.
Tilgang: Offentlig

Maskinlesbar kontrakt

OpenAPI-JSON for leverandører
/api/v1/supplier/openapi/v1

Offentlig kontrakt for planlegging og klientgenerering. Operativ leverandørtilgang er fortsatt tilgangsstyrt.

04

API for bedriftsidentitet

Koble godkjente bedriftsarbeidsområder til enkel pålogging, klargjøring av brukere og grupper og identitetslogger.

Dette dekker kontrakten
Enkel pålogging med OpenID Connect (OIDC), SCIM-handlinger for brukeres og gruppers livssyklus, rotering av SCIM-tokener og loggførte klargjøringshendelser.
Et praktisk utgangspunkt
Koble identitetsleverandøren til det godkjente arbeidsområdet. Planlegg pålogging, oppretting og fjerning av brukertilgang, og kontroller deretter gruppekoblinger og logger i avtalt testmiljø.
Tilgang
Spesifikasjonen for bedriftsidentitet er beskyttet. Kontakt integrasjonsteamet for å gjennomgå arbeidsområde og tilgangskrav før implementering. Bedriftsidentitet er valgfritt ved vanlige produktkjøp.
Tilgang: Beskyttet

Maskinlesbar kontrakt

OpenAPI-JSON for bedriftsidentitet
/api/v1/enterprise/identity/openapi/v1

Beskyttet kontrakt for godkjente bedriftsarbeidsområder; be om tilgang før endepunktet brukes.

Planlegg en integrasjon

02 — Implementeringsguide

Velg kontrakten før koden

  1. 01

    Kartlegg brukerreisen

    Avklar hvem som går inn i arbeidsflyten og hvor: en kjøper i en innebygd butikk, en godkjent leverandør, en bedriftsbruker eller en assistent med uttrykkelig autorisasjon.

  2. 02

    Bekreft tilgangsgrensen

    Bruk offentlige kontrakter til vurdering og klientgenerering, og bekreft deretter tilgangsopplysninger, omfang, miljøer, callbacks og beskyttede endepunkter før implementering.

  3. 03

    Dokumenter sammenheng i tilstanden

    Test at design, tilbud, godkjenninger, feil og ordreoverganger beholder riktig versjon gjennom integrasjonen, inkludert nye forsøk og tilbakeføring.

03 — Dette må alle integrasjoner bevare

Dette må alle integrasjoner bevare

Én versjonert tilstand

Design, kjøpshensikt, leverandørbekreftet tilbud, godkjenning og ordrestatus holdes sammen. Foreldede endringer må utløse en synlig tilstand for nytt tilbud eller ny gjennomgang.

Kommersielt personvern og leverandørkonfidensialitet

MerchandAise forblir kjøperens handelspartner og støtteansvarlig. Leverandøridentiteter, kontakter og interne data eksponeres ikke gjennom offentlige integrasjoner.

Godkjenning før produksjon

En 3D-visning er ikke fysisk dokumentasjon. Det bekreftede tilbudet forklarer eventuelle tilgjengelige prøvevalg, kostnader, begrensninger og tidsplan. Godkjenn den nøyaktige digitale korrekturen og fullfør obligatoriske tekniske kontroller og eventuell påkrevd eller valgt prøvegodkjenning før serieproduksjon. Krav i allerede aksepterte bestillinger er fortsatt bindende.

04

Før produksjonstrafikk

En publisert OpenAPI-fil er et planleggingsgrunnlag, ikke et løfte om anonym produksjonstilgang. Vi gjennomgår miljøer, tilgangsopplysninger, feilhåndtering og operativt ansvar før lansering.

01

Tilgang og miljøer

Bekreft kontraktversjon, godkjent arbeidsområde, autentiseringstilganger, testmiljø, produksjonstilganger og callback-adresser.

02

Feil og gjenoppretting

Definer nye forsøk, idempotens, tidsavbrudd, synlige feil for kunden, overvåking, støtteansvar og tilbakeføring før release.

03

Dokumentasjon fra hele forløpet

Kontroller den tiltenkte reisen i testmiljøet, fra inngang og tilstandsendring til tilbud, godkjenning, overgang og gjenoppretting.

Vanlige spørsmål

Hvilket profilprodukt-API bør jeg starte med?

Start med personen og tilstandsendringen. Bruk innebygde fellesskap til kjøperrettede klubb- og fellesskapsreiser, leverandørdrift til godkjente leverandørflyter, bedriftsidentitet til SSO og SCIM, og assistentverktøy bare til uttrykkelig autoriserte KI-ledede forløp.

Betyr en offentlig kontrakt offentlig produksjonstilgang?

Nei. En offentlig OpenAPI-kontrakt støtter oppdagelse, arkitekturgjennomgang og klientgenerering. Produksjonstilganger, skrivehandlinger, leverandørflyter, bedriftsidentitet og assistentkjøring kan fortsatt kreve et godkjent arbeidsområde og avgrenset autorisasjon.

Kan en integrasjon vise leverandører eller omgå godkjenninger?

Nei. Leverandøridentitet og kontaktopplysninger forblir private med unntak av påkrevd utlevering. MerchandAise eier kjøperforholdet, og handlinger som påvirker bestillinger, må bevare de fastsatte kravene til digital korrektur, tekniske kontroller og bestillingsspesifikk prøvegodkjenning.

Planlegg integrasjonen sammen med oss.

Fortell hvem som skal bruke integrasjonen, hvilken tilstand de må lese eller endre og hvor opplevelsen skal være. Vi kartlegger kontrakt, tilgangsmodell og tryggeste utrullingsforløp sammen med deg.