{"pageKey":"Developers","slug":"developers-api-integrations","locale":"no","localeResolved":"no","fallbackApplied":false,"version":"developers-api-integrations@2026-11-19T13:03:06.146Z","lastModified":null,"canonicalUrl":"https://www.merchandaise.com/no/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"API-dokumentasjon og OpenAPI for profilprodukter | MerchandAise","description":"Utforsk MerchandAises API-dokumentasjon og OpenAPI-spesifikasjoner for profilprodukter, innebygde fellesskap, leverandørflyter og bedriftsidentitet.","sections":[{"heading":"Velg koblingen prosjektet trenger","paragraphs":["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."]},{"heading":"API-er og integrasjonspunkter","items":[{"title":"API-dokumentasjon og OpenAPI","description":"Finn API-referansen for assistentverktøy og designøkter, og velg deretter fellesskaps-, leverandør- eller bedriftskontrakten som passer arbeidsflyten. Implementeringsguide: Les dokumentasjon for assistentverktøy (/api/docs). Maskinlesbar spesifikasjon: OpenAPI-JSON for assistentverktøy (/api/docs/openapi.json). Tilgang: Offentlig. Offentlig referanse for assistent- og verktøy-API-er. Produksjonstilgang og handlinger som påvirker bestillinger, krever fortsatt relevant autorisasjon. Kanonisk side: /no/developers/api-integrations. Kanonisk seksjon: /no/developers/api-integrations#api-docs."},{"title":"Fellesskaps-API","description":"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. Implementeringsguide: Utforsk fellesskaps-API-et (/no/developers/api-integrations#community-integrations). Maskinlesbar spesifikasjon: OpenAPI-JSON for fellesskap (/api/v1/community/public/openapi/v1). Tilgang: Offentlig. Offentlig versjonert kontrakt for innebygde butikker, oppdagelse av fellesskap og språktilpassede overganger. Kanonisk side: /no/developers/api-integrations. Kanonisk seksjon: /no/developers/api-integrations#community-integrations."},{"title":"Leverandør-API","description":"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. Implementeringsguide: Utforsk leverandør-API-et (/no/developers/api-integrations#supplier-integrations). Maskinlesbar spesifikasjon: OpenAPI-JSON for leverandører (/api/v1/supplier/openapi/v1). Tilgang: Offentlig. Offentlig kontrakt for planlegging og klientgenerering. Operativ leverandørtilgang er fortsatt tilgangsstyrt. Kanonisk side: /no/developers/api-integrations. Kanonisk seksjon: /no/developers/api-integrations#supplier-integrations."},{"title":"API for bedriftsidentitet","description":"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. Implementeringsguide: Utforsk bedriftsidentitet (/no/developers/api-integrations#enterprise-integrations). Maskinlesbar spesifikasjon: OpenAPI-JSON for bedriftsidentitet (/api/v1/enterprise/identity/openapi/v1). Tilgang: Beskyttet. Beskyttet kontrakt for godkjente bedriftsarbeidsområder; be om tilgang før endepunktet brukes. Kanonisk side: /no/developers/api-integrations. Kanonisk seksjon: /no/developers/api-integrations#enterprise-integrations."}]},{"heading":"Velg kontrakten før koden","items":[{"title":"Steg 1: Kartlegg brukerreisen","description":"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."},{"title":"Steg 2: Bekreft tilgangsgrensen","description":"Bruk offentlige kontrakter til vurdering og klientgenerering, og bekreft deretter tilgangsopplysninger, omfang, miljøer, callbacks og beskyttede endepunkter før implementering."},{"title":"Steg 3: Dokumenter sammenheng i tilstanden","description":"Test at design, tilbud, godkjenninger, feil og ordreoverganger beholder riktig versjon gjennom integrasjonen, inkludert nye forsøk og tilbakeføring."}]},{"heading":"Dette må alle integrasjoner bevare","items":[{"title":"Én versjonert tilstand","description":"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."},{"title":"Kommersielt personvern og leverandørkonfidensialitet","description":"MerchandAise forblir kjøperens handelspartner og støtteansvarlig. Leverandøridentiteter, kontakter og interne data eksponeres ikke gjennom offentlige integrasjoner."},{"title":"Godkjenning før produksjon","description":"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."}]},{"heading":"Før produksjonstrafikk","paragraphs":["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."],"items":[{"title":"Tilgang og miljøer","description":"Bekreft kontraktversjon, godkjent arbeidsområde, autentiseringstilganger, testmiljø, produksjonstilganger og callback-adresser."},{"title":"Feil og gjenoppretting","description":"Definer nye forsøk, idempotens, tidsavbrudd, synlige feil for kunden, overvåking, støtteansvar og tilbakeføring før release."},{"title":"Dokumentasjon fra hele forløpet","description":"Kontroller den tiltenkte reisen i testmiljøet, fra inngang og tilstandsendring til tilbud, godkjenning, overgang og gjenoppretting."}]},{"heading":"Vanlige spørsmål","items":[{"title":"Hvilket profilprodukt-API bør jeg starte med?","description":"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."},{"title":"Betyr en offentlig kontrakt offentlig produksjonstilgang?","description":"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."},{"title":"Kan en integrasjon vise leverandører eller omgå godkjenninger?","description":"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."}]},{"heading":"Planlegg integrasjonen sammen med oss.","paragraphs":["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."],"items":[{"title":"Planlegg en integrasjon","description":"/no/contact?intent=api-integration-review"},{"title":"Utforsk KI-agenter og MCP","description":"/no/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"route-owned-source","schema":"2025-11-05"}}