# Merchandise-API: Dokumentation og OpenAPI | MerchandAise

- slug: developers-api-integrations
- locale: da
- localeResolved: da
- canonical: https://www.merchandaise.com/da/developers/api-integrations

Udforsk MerchandAises API-dokumentation og OpenAPI-specifikationer til merchandise, indlejrede fællesskaber, leverandørforløb og virksomhedsidentitet.

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

## API- og integrationsgrænseflader
- **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øjer (/api/docs). Maskinlæsbar specifikation: OpenAPI-JSON til assistentværktøjer (/api/docs/openapi.json). Adgang: Offentlig. Offentlig reference til assistent- og værktøjs-API'er. Produktionsadgang og handlinger, der påvirker bestillinger, kræver stadig relevant godkendelse. Kanonisk side: /da/developers/api-integrations. Kanonisk sektion: /da/developers/api-integrations#api-docs.
- **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. Implementeringsvejledning: Udforsk fællesskabs-API'et (/da/developers/api-integrations#community-integrations). Maskinlæsbar specifikation: OpenAPI-JSON til fællesskaber (/api/v1/community/public/openapi/v1). Adgang: Offentlig. Offentlig versioneret kontrakt til indlejrede butikker, søgning efter fællesskaber og sprogspecifikke overgange. Kanonisk side: /da/developers/api-integrations. Kanonisk sektion: /da/developers/api-integrations#community-integrations.
- **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. Implementeringsvejledning: Udforsk leverandør-API'et (/da/developers/api-integrations#supplier-integrations). Maskinlæsbar specifikation: OpenAPI-JSON til leverandører (/api/v1/supplier/openapi/v1). Adgang: Offentlig. Offentlig kontrakt til planlægning og klientgenerering. Driftsadgang for leverandører kræver fortsat tilladelse. Kanonisk side: /da/developers/api-integrations. Kanonisk sektion: /da/developers/api-integrations#supplier-integrations.
- **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. Implementeringsvejledning: Udforsk virksomhedsidentitet (/da/developers/api-integrations#enterprise-integrations). Maskinlæsbar specifikation: OpenAPI-JSON til virksomhedsidentitet (/api/v1/enterprise/identity/openapi/v1). Adgang: Beskyttet. Beskyttet kontrakt til godkendte virksomhedsarbejdsområder. Bed om adgang, før du bruger dette endpoint. Kanonisk side: /da/developers/api-integrations. Kanonisk sektion: /da/developers/api-integrations#enterprise-integrations.

## Vælg kontrakten før koden
- **Trin 1: 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.
- **Trin 2: 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.
- **Trin 3: 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.

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

## 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.
- **Planlæg en integration:** /da/contact?intent=api-integration-review
- **Udforsk AI-agenter og MCP:** /da/developers/ai-agents-mcp
