Gå til hovedindhold

MerchandAises udviklerplatform

Forbind din arbejdsgang med MerchandAise.

Find API-dokumentation og OpenAPI-specifikationer til merchandise med eget design. Forbind hjemmesider, fællesskaber, leverandørdrift eller virksomhedskonti med fælles design-, tilbuds- og ordreoplysninger.

Vælg den forbindelse, projektet har brug for

Brug referencerne herunder til at vurdere endpoints, forespørgselsformater og adgangskrav. Offentlige specifikationer understøtter planlægning og klientgenerering. Driftsadgang afhænger af API, konto og miljø.

Når MerchandAise behandler købertransaktionen, er Hutter Products GmbH aftalepart som sælger og Merchant of Record under MerchandAise-brandet. Leverandøridentitet og kontaktoplysninger forbliver private, medmindre videregivelse er påkrævet. Produktion kræver stadig digital korrekturgodkendelse, bekræftet fremstillingsmulighed, obligatoriske tekniske kontroller og de prøvegodkendelser, der gælder for den konkrete accepterede bestilling.

01 — Kontrakter

API- og integrationsgrænseflader

01

API-dokumentation og OpenAPI

Find API-referencen til assistentværktøjer og designsessioner, og vælg derefter fællesskabs-, leverandør- eller virksomhedskontrakten til din arbejdsgang.

Adgang: Offentlig/api/docs/openapi.json

Offentlig reference til assistent- og værktøjs-API'er. Produktionsadgang og handlinger, der påvirker bestillinger, kræver stadig relevant godkendelse.

02

Fællesskabs-API

Forbind en klub- eller fællesskabshjemmeside med offentlige fællesskabsoplysninger, designindsendelser, afstemninger og overgange til ordregodkendelse.

Det omfatter kontrakten
Offentlig fællesskabskontekst, designopslag og stemmer, offentliggørelse af produkter, afventende bestillinger og fællesskabsejerens godkendelse eller afvisning.
Et praktisk udgangspunkt
Læs offentlig fællesskabskontekst til en klubhjemmeside. Kortlæg derefter, hvilke handlinger der kræver medlemssession eller ejerrettigheder, før du tilføjer designindsendelser eller overgange til bestilling.
Adgang
Specifikationen er offentlig. Offentlige læsninger, medlemshandlinger og handlinger kun for ejere har forskellige adgangskrav. Brug sikkerhedsreglerne på hvert endpoint.
Adgang: Offentlig/api/v1/community/public/openapi/v1

Offentlig versioneret kontrakt til indlejrede butikker, søgning efter fællesskaber og sprogspecifikke overgange.

03

Leverandør-API

Forbind godkendte leverandørsystemer med frigivne produktionspakker, onboardingstatus og webhookforløb til ERP eller PLM.

Det omfatter kontrakten
Status for leverandøronboarding, frigivne produktionspakker, dokumenterede artefaktdownloads, analyser, webhookabonnementer og synkroniseringskontrolpunkter.
Et praktisk udgangspunkt
Planlæg en forbindelse mellem jeres ERP- eller produktlivscyklussystem og Leverandørcenteret. Gennemgå webhookindhold, genforsøg og synkroniseringsstatus, før en tildelt bestilling håndteres.
Adgang
Læs OpenAPI-specifikationen uden at logge ind. Driftsforespørgsler kræver den rette leverandørkonto og de rette tilladelser. Offentlig dokumentation tilmelder ikke en leverandør og giver ikke adgang til andre leverandørers data.
Adgang: Offentlig/api/v1/supplier/openapi/v1

Offentlig kontrakt til planlægning og klientgenerering. Driftsadgang for leverandører kræver fortsat tilladelse.

04

API til virksomhedsidentitet

Forbind godkendte virksomhedsarbejdsområder med enkeltlogin, bruger- og gruppeadministration og revisionsspor for identitet.

Det omfatter kontrakten
Enkeltlogin med OpenID Connect (OIDC), SCIM-livscyklus for brugere og grupper, rotation af SCIM-tokens og revisionshændelser for brugeradministration.
Et praktisk udgangspunkt
Knyt jeres identitetsudbyder til det godkendte arbejdsområde. Planlæg login, oprettelse og fjernelse af brugere, og kontrollér derefter gruppetilknytninger og revisionsspor i det aftalte testmiljø.
Adgang
Specifikationen for virksomhedsidentitet er beskyttet. Kontakt integrationsteamet for at gennemgå arbejdsområdet og adgangskravene før implementering. Virksomhedsidentitet er valgfri ved almindelige produktkøb.
Adgang: Beskyttet

Maskinkontrakt

OpenAPI-JSON til virksomhedsidentitet
/api/v1/enterprise/identity/openapi/v1

Beskyttet kontrakt til godkendte virksomhedsarbejdsområder. Bed om adgang, før du bruger dette endpoint.

Planlæg en integration

02 — Implementeringsvejledning

Vælg kontrakten før koden

  1. 01

    Kortlæg brugerforløbet

    Afgør, hvem der går ind i arbejdsgangen og hvor: en køber i en indlejret butik, en godkendt leverandør, en virksomhedsbruger eller en assistent med udtrykkelig tilladelse.

  2. 02

    Bekræft adgangsgrænsen

    Brug offentlige kontrakter til vurdering og klientgenerering. Bekræft derefter legitimationsoplysninger, rettigheder, miljøer, callbacks og beskyttede endpoints før implementering.

  3. 03

    Dokumentér sammenhæng i tilstanden

    Test, at design, tilbud, godkendelser, fejl og ordreovergange bevarer aktuelle versioner på tværs af integrationen, herunder genforsøg og tilbagerulning.

03 — Det skal hver integration bevare

Det skal hver integration bevare

Én versioneret tilstand

Design, købsintention, leverandørbekræftet tilbud, godkendelse og ordrestatus forbliver forbundet. Forældede ændringer skal udløse en synlig tilstand for nyt tilbud eller gennemgang.

Kommerciel fortrolighed og leverandørbeskyttelse

MerchandAise forbliver sælger over for køberen og ansvarlig for support. Leverandøridentiteter, kontakter og interne data vises ikke via offentlige integrationer.

Godkendelse før produktion

En 3D-visning er ikke fysisk dokumentation. Det bekræftede tilbud forklarer eventuelle muligheder for kundeprøver samt omkostninger, begrænsninger og tidsplan. Godkend den præcise digitale korrektur, og gennemfør obligatoriske tekniske kontroller og eventuel påkrævet eller valgt prøvegodkendelse inden masseproduktion. Eksisterende krav for accepterede bestillinger forbliver bindende.

04

Før produktionstrafik

En offentliggjort OpenAPI-fil er et planlægningsgrundlag, ikke et løfte om anonym produktionsadgang. Vi gennemgår miljøer, legitimationsoplysninger, fejlhåndtering og driftsansvar før idriftsættelse.

01

Adgang og miljøer

Bekræft kontraktversion, godkendt arbejdsområde, autentificeringsrettigheder, testmiljø, produktionslegitimationsoplysninger og callbackdestinationer.

02

Fejl og gendannelse

Definér genforsøg, idempotens, tidsgrænser, synlige fejl, overvågning, supportansvar og tilbagerulning før udgivelse.

03

Dokumentation for hele forløbet

Kontrollér det ønskede forløb i testmiljøet fra start og tilstandsændringer gennem tilbud, godkendelse, overdragelse og gendannelse.

Ofte stillede spørgsmål

Hvilket merchandise-API bør jeg starte med?

Start med personen og tilstandsændringen. Brug indlejrede fællesskaber til køberrettede klub- og fællesskabsforløb, leverandørdrift til godkendte leverandørforløb, virksomhedsidentitet til SSO og SCIM og assistentværktøjer kun til AI-forløb med udtrykkelig tilladelse.

Betyder en offentlig kontrakt offentlig produktionsadgang?

Nej. En offentlig OpenAPI-kontrakt understøtter søgning, arkitekturgennemgang og klientgenerering. Produktionslegitimationsoplysninger, skrivehandlinger, leverandørforløb, virksomhedsidentitet og assistenthandlinger kan stadig kræve et godkendt arbejdsområde og afgrænset adgang.

Kan en integration afsløre leverandører eller omgå godkendelser?

Nej. Leverandøridentitet og kontaktoplysninger forbliver private, medmindre videregivelse er påkrævet. MerchandAise har kunderelationen, og handlinger, der påvirker bestillinger, skal bevare de konfigurerede krav til digital korrektur, tekniske kontroller og prøvegodkendelse for bestillingen.

Planlæg integrationen sammen med os.

Fortæl, hvem der skal bruge integrationen, hvilken tilstand de skal læse eller ændre, og hvor oplevelsen skal ligge. Vi kortlægger kontrakt, adgangsmodel og den sikreste lanceringsvej sammen med dig.