# Utviklerportal: profilprodukt-API-er, OpenAPI og MCP | MerchandAise

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

Bygg integrasjoner for profilprodukter med MerchandAise-API-er. Utforsk OpenAPI, innebygde fellesskap, leverandørflyter, bedrifts-SSO og MCP-verktøy.

## MerchandAises utviklerportal
Koble nettstedet, bedriftssystemene eller KI-assistenten til MerchandAise. Utforsk API-er for produktdesign, fellesskapsbutikker, leverandørdrift og bedriftsidentitet, med OpenAPI-spesifikasjoner og MCP-dokumentasjon som veiledning for integrasjonen.

## Laget for systemene rundt profilprogrammet ditt
- **Ansvarlige for fellesskap:** Legg inn butikker, overganger til konfiguratoren og fellesskapsflyter i nettsider for klubber, ligaer og bedrifter med versjonerte offentlige kontrakter.
- **Bedriftsteam og plattformpartnere:** Koble innkjøpsportaler, identitetssystemer og intern drift til profilproduktflyter uten å bygge godkjennings- og leverandørlogikk på nytt.
- **Utviklere av KI-agenter og automatisering:** Gi assistenter strukturert verktøytilgang til produktoppdagelse, tilbud og godkjente handlinger via MCP-kompatible endepunkter.

## Finn integrasjonen din
- **API-dokumentasjon og OpenAPI:** Finn API-referansen for assistentverktøy og designøkter, og velg deretter fellesskaps-, leverandør- eller bedriftskontrakten som passer arbeidsflyten. Implementeringsguide: Utforsk API-dokumentasjonen (/no/developers/api-integrations). 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 seksjon: /no/developers#api-docs.
- **Fellesskaps-API:** Koble en klubb- eller fellesskapsnettside til offentlig fellesskapsinformasjon, designinnsendinger, avstemninger og overganger til ordregodkjenning. 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 seksjon: /no/developers#community-integrations.
- **Leverandør-API:** Koble godkjente leverandørsystemer til frigitte produksjonspakker, registreringsstatus og ERP- eller PLM-webhookflyter. 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 seksjon: /no/developers#supplier-integrations.
- **API for bedriftsidentitet:** Koble godkjente bedriftsarbeidsområder til enkel pålogging, klargjøring av brukere og grupper og identitetslogger. 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 seksjon: /no/developers#enterprise-integrations.
- **KI-agenter og MCP:** Koble en KI-assistent gjennom Model Context Protocol. Finn støttede verktøy, og bevar brukerens designvalg, tillatelser og nødvendige bekreftelser. Implementeringsguide: Utforsk KI-agenter og MCP (/no/developers/ai-agents-mcp). Maskinlesbar spesifikasjon: Offentlig MCP-serverkort i JSON (/.well-known/mcp/server-card). Tilgang: Offentlig. Offentlig oppdagelsesdokument for maskinklienter. Den eksterne verktøylisten på /api/v1/mcp/tools viser gjeldende verktøymetadata; hvert verktøykall følger fortsatt sine oppgitte sikkerhets-, arbeidsområde- og bekreftelsesgrenser. Kanonisk seksjon: /no/developers#mcp-tools.

## Fra første forespørsel til produksjon
- **Steg 1: Velg kontrakten som passer arbeidsflyten:** Start med integrasjonspunktet som passer brukeren og autentiseringsmodellen: innebygd fellesskap, bedriftsidentitet, leverandørdrift eller MCP-verktøy for assistenter.
- **Steg 2: Kontroller autentisering, versjonering og miljøgrenser:** Bekreft nødvendige headere, tilganger, callback-forventninger og kontraktversjoner i testmiljøet før produksjonstrafikk rutes.
- **Steg 3: Test hele arbeidsflyten før lansering:** Kontroller forespørsler, webhooks, klargjøring, overvåking og tilbakeføringsmuligheter, slik at integrasjonen er pålitelig fra første bruk i produksjon.

## Hva produksjonsklar betyr
En produksjonsintegrasjon trenger mer enn et offentlig endepunkt. Bruk disse kontrollpunktene til å avgjøre om arbeidsflyten er klar for kunde-, leverandør-, bedrifts- eller KI-agenttrafikk.
- **Testmiljø og tilgangsgjennomgang:** Bekreft hvilke kontrakter som er offentlige, hvilke bedriftstjenester som krever godkjenning og hvilke tilgangsopplysninger eller arbeidsområderoller som trengs før lansering.
- **Versjonert implementeringsdokumentasjon:** Dokumenter genererte klienter, callback-URL-er, autentiseringstilganger, kontraktversjoner og ansvar for tilbakeføring før produksjonstrafikk aktiveres.
- **Operativ overvåking:** Planlegg logger, nye forsøk, støtteansvar, feiltilstander og helsesjekker for hver arbeidsflyt som kan påvirke en bestilling, leverandør eller bedriftsbruker.

## Før du begynner å bygge
- **Hvilket MerchandAise-API bør jeg bruke?:** Bruk fellesskaps-API-et til klubb- og fellesskapsnettsider, leverandør-API-et til godkjent leverandørdrift og API-et for bedriftsidentitet til bedriftspålogging og klargjøring. API-referansen dekker assistentverktøy; MCP-guiden forklarer hvordan KI-assistenter finner og bruker støttede verktøy.
- **Kan jeg lese API-spesifikasjonene uten konto?:** OpenAPI-spesifikasjonene for assistentverktøy, fellesskap og leverandører er offentlige. Spesifikasjonen for bedriftsidentitet er beskyttet. Å lese en offentlig spesifikasjon gir ikke tillatelse til å utføre beskyttede forespørsler eller legge inn bestillinger.
- **Trenger jeg en utviklerintegrasjon for å bestille et produkt?:** Nei. Privatpersoner, klubber og bedrifter kan bruke MerchandAise-nettstedet til å utforske støttede produkter og be om tilbud. API-er er en valgfri måte å koble til egne systemer eller opplevelser på.
- **Hva bør jeg ta med i en integrasjonsforespørsel?:** Beskriv hvem som skal bruke den, involverte systemer, informasjonen du trenger å lese eller oppdatere og ønsket tidsplan. Ta med krav til pålogging, miljø og callback hvis de er kjent. Teamet gjennomgår riktig kontrakt og tilgangsmodell sammen med deg.

## Planlegger du en egen integrasjon?
Del systemene som er involvert, arbeidsflyten du vil støtte og tidsplanen for utrulling. Vi hjelper deg å velge riktig kontrakt, tilgangsmodell og lanseringsrekkefølge.
- **Snakk om en integrasjon:** /no/contact/integrations
- **Utforsk bedriftstilbudet:** /no/enterprise
