# Merchandise API- og integrasjonskontrakter | MerchandAise

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

Utforsk MerchandAise-kontrakter for assistentverktøy, integrering i samfunn, leverandørdrift og bedriftsidentitet, med tydelige grenser for offentlig og beskyttet tilgang.

## Behold én felles kilde til sannhet
En integrasjon skal utvide MerchandAise-arbeidsflyten, ikke splitte den. Nettsteder, innebygde løsninger, leverandører, bedrifter og fremtidige assistentgrensesnitt må lese og oppdatere samme versjonerte design, handelsintensjon, tilbud, godkjenning og ordrestatus.
Der MerchandAise behandler kjøperens transaksjon, er Hutter Products GmbH den avtalepartneren og Merchant of Record under MerchandAise-merkevaren. Leverandøridentitet og kontaktopplysninger forblir private unntatt der offentliggjøring er påkrevd, og produksjon krever fortsatt godkjenning av digital korrektur og en fysisk produksjonsprøve.

## API- og integrasjonsgrensesnitt
- **API-dokumentasjon for assistentverktøy:** Utforsk nåværende endepunkter for assistenter og verktøy for designøkter og integrasjonsgjennomgang. Denne offentlige referansen gir ikke anonym rett til å gi tilbud eller legge inn en bestilling. Human guide: Åpne dokumentasjon for assistentverktøy (/no/developers/api-integrations). Machine-readable contract: OpenAPI JSON for assistentverktøy (/api/docs/openapi.json). Access: public. Offentlig referanse for assistent- og verktøy-API-er. Produksjonstilgang og ordre-påvirkende operasjoner krever fortsatt gjeldende autorisasjon. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs.
- **API for samfunnsintegrasjon:** Koble lokaliserte klubb-, samfunns- eller nettbutikkopplevelser til MerchandAise-eide design- og handelsoverganger uten å måtte bygge opp den underliggende arbeidsflyten på nytt. Human guide: Gå gjennom veiledning for samfunnsintegrasjon (/no/developers/api-integrations#community-integrations). Machine-readable contract: OpenAPI JSON for samfunn (/api/v1/community/public/openapi/v1). Access: public. Offentlig versjonert kontrakt for innebygde nettbutikker, samfunnsoppdagelse og lokaltilpassede overganger. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations.
- **Leverandør-API:** Koble godkjente leverandører til onboarding-, katalog-, tilbuds- og oppfyllingsprosesser etter at leverandørforholdet og tilgangsmodellen er kvalifisert. Human guide: Gå gjennom veiledning for leverandørintegrasjon (/no/developers/api-integrations#supplier-integrations). Machine-readable contract: OpenAPI JSON for leverandør (/api/v1/supplier/openapi/v1). Access: public. Offentlig kontrakt for planlegging og klientgenerering. Operasjonell leverandørtilgang forblir rettighetsstyrt. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations.
- **API for bedriftsidentitet:** Planlegg SSO, SCIM-provisjonering og revisjonsklare identitetsflyter for godkjente profilprogrammer og styrte utrullinger. Human guide: Gå gjennom veiledning for bedriftsintegrasjon (/no/developers/api-integrations#enterprise-integrations). Machine-readable contract: OpenAPI JSON for bedriftsidentitet (/api/v1/enterprise/identity/openapi/v1). Access: protected. Beskyttet kontrakt for godkjente bedriftsområder; be om tilgang før du bruker dette endepunktet. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

## Velg kontrakten før koden
- **Step 1: Kartlegg brukerreisen:** Bestem hvem som går inn i arbeidsflyten og hvor: en kjøper i en innebygd nettbutikk, en godkjent leverandør, en bedriftsbruker eller en assistent som opererer med eksplisitt autorisasjon.
- **Step 2: Bekreft tilgangsgrensen:** Bruk offentlige kontrakter til evaluering og klientgenerering, og bekreft deretter legitimasjon, tilgangsomfang (scopes), miljøer, tilbakeslag (callbacks) og beskyttede endepunkter før implementering.
- **Step 3: Bevis kontinuitet i status:** Test at design, tilbud, godkjenninger, feil og ordreoverganger forblir oppdatert med riktig versjon på tvers av integrasjonen, inkludert forsøk på nytt og tilbakerullingsveier.

## Hva enhver integrasjon må ivareta
- **Én versjonert status:** Design, handelsintensjon, leverandørstøttet tilbud, godkjenning og ordrestatus forblir sammenkoblet. Foreldede endringer må utløse et synlig nytt tilbud eller en vurderingsstatus.
- **Kommersielt personvern og leverandørkonfidensialitet:** MerchandAise forblir den kjøpervendte forhandleren og supportansvarlige. Leverandøridentiteter, kontakter og interne data blir ikke eksponert gjennom offentlige integrasjoner.
- **Godkjenning før produksjon:** En produkt-naturlig 3D-visning og digital korrektur støtter beslutningen, men de erstatter ikke den fysiske produksjonsprøven som kreves før masseproduksjon.

## Før produksjonstrafikk
En publisert OpenAPI-fil er et planleggingsgrunnlag, ikke et løfte om anonym produksjonstilgang. Vi går gjennom miljøer, legitimasjon, feilhåndtering og operasjonelt eierskap før lansering.
- **Tilgang og miljøer:** Bekreft kontraktversjon, godkjent arbeidsområde, autentiseringsomfang (scopes), sandkasse, produksjonslegitimasjon og destinasjoner for tilbakeslag (callbacks).
- **Feil og gjenoppretting:** Definer nye forsøk, idempotens, tidsavbrudd, feil synlige for kunden, observerbarhet, supporteierskap og tilbakerulling før utgivelse.
- **Ende-til-ende-bevis:** Bekreft den tiltenkte reisen i staging-miljøet fra inngang og statusendring, gjennom tilbud, godkjenning, overlevering og gjenopprettingsatferd.

## FAQ
- **Hvilket integrasjonsgrensesnitt bør jeg starte med?:** Start med personen og statusovergangen. Bruk samfunnsintegrasjoner for kjøpervendte klubb- eller samfunnsreiser, leverandørdrift for godkjente arbeidsflyter på leverandørsiden, bedriftsidentitet for SSO og SCIM, og assistentverktøy kun for eksplisitt autoriserte AI-ledede flyter.
- **Betyr en offentlig kontrakt at man har offentlig produksjonstilgang?:** Nei. En offentlig OpenAPI-kontrakt støtter oppdagelse, arkitekturvurdering og klientgenerering. Produksjonslegitimasjon, skriveoperasjoner, leverandørarbeidsflyter, bedriftsidentitet og assistentkjøring kan fortsatt kreve et godkjent arbeidsområde og avgrenset autorisasjon.
- **Kan en integrasjon eksponere leverandører eller omgå godkjenninger?:** Nei. Leverandøridentitet og kontaktopplysninger forblir private unntatt der offentliggjøring er påkrevd, MerchandAise eier kjøpsforholdet, og handlinger som påvirker bestillingen må ivareta de konfigurerte godkjennings- og fysiske prøve-stegene.

## Ta med deg arbeidsflyten til oss, ikke en ferdig arkitektur.
Fortell oss hvem som skal bruke integrasjonen, hvilken status de trenger å lese eller endre, og hvor opplevelsen skal leve. Vi vil kartlegge kontrakten, tilgangsmodellen og den sikreste utrullingsveien sammen med deg.
- **Planlegg en integrasjon:** /no/contact?intent=api-integration-review
- **Utforsk AI-agenter og MCP:** /no/developers/ai-agents-mcp