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.
Implementeringsvejledning
Læs dokumentation til assistentværktøjerMaskinkontrakt
OpenAPI-JSON til assistentværktøjer/api/docs/openapi.jsonOffentlig 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.
Maskinkontrakt
OpenAPI-JSON til fællesskaber/api/v1/community/public/openapi/v1Offentlig 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.
Maskinkontrakt
OpenAPI-JSON til leverandører/api/v1/supplier/openapi/v1Offentlig 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.
Maskinkontrakt
OpenAPI-JSON til virksomhedsidentitet/api/v1/enterprise/identity/openapi/v1Beskyttet kontrakt til godkendte virksomhedsarbejdsområder. Bed om adgang, før du bruger dette endpoint.
Planlæg en integration02 — Implementeringsvejledning
Vælg kontrakten før koden
- 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.
- 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.
- 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.
Adgang og miljøer
Bekræft kontraktversion, godkendt arbejdsområde, autentificeringsrettigheder, testmiljø, produktionslegitimationsoplysninger og callbackdestinationer.
Fejl og gendannelse
Definér genforsøg, idempotens, tidsgrænser, synlige fejl, overvågning, supportansvar og tilbagerulning før udgivelse.
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.