# Kehittäjäkeskus: tuote-API:t, OpenAPI ja MCP | MerchandAise

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

Rakenna personoitujen tuotteiden integraatioita MerchandAisen rajapinnoilla. Tutustu OpenAPI-ohjeisiin, yhteisöupotuksiin, toimittajien työnkulkuihin, yritysten SSO:hon ja MCP-työkaluihin.

## MerchandAisen kehittäjäkeskus
Yhdistä verkkosivusi, liiketoimintajärjestelmäsi tai tekoälyavustajasi MerchandAiseen. Tutustu tuotesuunnittelun, yhteisökauppojen, toimittajatoimintojen ja yritysten tunnistautumisen rajapintoihin. OpenAPI-määritykset ja MCP-dokumentaatio ohjaavat integraatiotasi.

## Tuoteprojektisi ympärillä oleville järjestelmille
- **Yhteisöjen ylläpitäjät:** Toteuta upotetut kaupat, siirtymät konfiguraattoriin ja yhteisöjen työnkulut seurojen, liigojen ja yritysten sivustoilla versioitujen julkisten määritysten avulla.
- **Yritystiimit ja alustakumppanit:** Yhdistä hankintaportaalit, tunnistusjärjestelmät ja sisäinen toiminta tuoteprosessiin rakentamatta hyväksyntä- ja toimittajalogiikkaa uudelleen.
- **Tekoälyagenttien ja automaatioiden kehittäjät:** Anna avustajille rakenteinen työkalujen käyttöoikeus löytämiseen, tarjouksiin ja hyväksyttyihin toimintoihin MCP-yhteensopivien päätepisteiden kautta.

## Löydä integraatiosi
- **API-dokumentaatio ja OpenAPI:** Etsi avustajien työkalujen ja suunnitteluistuntojen API-viite. Valitse sitten työnkulkuusi sopiva yhteisö-, toimittaja- tai yritysmääritys. Toteutusopas: Tutustu API-ohjeisiin (/fi/developers/api-integrations). Koneluettava määritys: Avustajatyökalujen OpenAPI JSON (/api/docs/openapi.json). Käyttöoikeus: Julkinen. Julkinen viite avustajien ja työkalujen rajapinnoille. Tuotantokäyttö ja tilauksiin vaikuttavat toiminnot edellyttävät yhä soveltuvaa valtuutusta. Ensisijainen osio: /fi/developers#api-docs.
- **Yhteisö-API:** Yhdistä seuran tai yhteisön sivusto julkisiin yhteisötietoihin, suunnitelmien lähettämiseen, äänestämiseen ja tilauksen hyväksyntään siirtymiseen. Toteutusopas: Tutustu Yhteisö-APIin (/fi/developers/api-integrations#community-integrations). Koneluettava määritys: Yhteisön OpenAPI JSON (/api/v1/community/public/openapi/v1). Käyttöoikeus: Julkinen. Julkinen versioitu määritys kauppaupotuksiin, yhteisöjen löytämiseen ja kieliversion säilyttäviin siirtymiin. Ensisijainen osio: /fi/developers#community-integrations.
- **Toimittaja-API:** Yhdistä hyväksyttyjen toimittajien järjestelmät julkaistuihin tuotantopaketteihin, perehdytystilaan ja ERP- tai PLM-webhook-työnkulkuihin. Toteutusopas: Tutustu Toimittaja-APIin (/fi/developers/api-integrations#supplier-integrations). Koneluettava määritys: Toimittajan OpenAPI JSON (/api/v1/supplier/openapi/v1). Käyttöoikeus: Julkinen. Julkinen määritys suunnittelua ja asiakasohjelmien generointia varten. Toimittajan operatiivinen käyttö edellyttää käyttöoikeuksia. Ensisijainen osio: /fi/developers#supplier-integrations.
- **Yritysten tunnistautumis-API:** Yhdistä hyväksytyt yritystyötilat kertakirjautumiseen, käyttäjien ja ryhmien hallintaan sekä tunnistautumisen tarkistuslokiin. Toteutusopas: Tutustu yritysten tunnistautumiseen (/fi/developers/api-integrations#enterprise-integrations). Koneluettava määritys: Yritystunnistuksen OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Käyttöoikeus: Suojattu. Suojattu määritys hyväksytyille yritystyötiloille. Pyydä käyttöoikeus ennen tämän päätepisteen käyttämistä. Ensisijainen osio: /fi/developers#enterprise-integrations.
- **Tekoälyagentit ja MCP:** Yhdistä tekoälyavustaja Model Context Protocolin kautta. Löydä tuetut työkalut ja säilytä käyttäjän suunnitteluvalinnat, käyttöoikeudet ja vaaditut vahvistukset. Toteutusopas: Tutustu tekoälyagentteihin ja MCP:hen (/fi/developers/ai-agents-mcp). Koneluettava määritys: Julkinen MCP-palvelinkortti JSON (/.well-known/mcp/server-card). Käyttöoikeus: Julkinen. Julkinen löytämisasiakirja koneasiakkaille. Ulkoinen työkaluluettelo osoitteessa /api/v1/mcp/tools näyttää ajantasaiset työkalutiedot. Jokainen työkalukutsu noudattaa silti ilmoitettuja turvallisuus-, työtila- ja vahvistusrajoja. Ensisijainen osio: /fi/developers#mcp-tools.

## Ensimmäisestä pyynnöstä tuotantoon
- **Vaihe 1: Valitse työnkulkuusi sopiva määritys:** Aloita käyttäjääsi ja valtuutusmalliasi vastaavasta rajapinnasta: yhteisöupotus, yritystunnistus, toimittajatoiminnot tai avustajien MCP-työkalut.
- **Vaihe 2: Vahvista tunnistautuminen, versiointi ja ympäristörajat:** Vahvista vaaditut otsakkeet, käyttöoikeusalueet, paluukutsujen odotukset ja määritysversiot testiympäristössä ennen tuotantoliikenteen ohjaamista.
- **Vaihe 3: Testaa koko työnkulku ennen julkaisua:** Vahvista pyynnöt, webhookit, käyttäjähallinta, havainnoitavuus ja palautuspolut, jotta integraatio on luotettava ensimmäisestä tuotantokäytöstä lähtien.

## Mitä tuotantovalmius tarkoittaa
Tuotantointegraatio vaatii enemmän kuin julkisen päätepisteen. Arvioi näiden tarkistusten avulla, onko työnkulku valmis asiakkaiden, toimittajien, yritysten tai tekoälyagenttien liikenteelle.
- **Testiympäristön ja käyttöoikeuksien arviointi:** Vahvista ennen julkaisua, mitkä määritykset ovat julkisia, mitkä yritysrajapinnat vaativat hyväksynnän ja mitä tunnistetietoja tai työtilarooleja tarvitaan.
- **Versioidun toteutuksen näyttö:** Dokumentoi generoidut asiakasohjelmat, paluukutsuosoitteet, käyttöoikeusalueet, määritysversiot ja palautuksesta vastaava taho ennen tuotantoliikenteen sallimista.
- **Toiminnan seurattavuus:** Suunnittele lokit, uudelleenyritykset, tukivastuut, virhetilat ja terveystarkistukset jokaiselle tilaukseen, toimittajaan tai yrityskäyttäjään vaikuttavalle työnkululle.

## Ennen kehittämisen aloittamista
- **Mitä MerchandAisen APIa minun kannattaa käyttää?:** Käytä Yhteisö-APIa seurojen ja yhteisöjen sivustotyönkulkuihin, Toimittaja-APIa hyväksyttyihin toimittajatoimintoihin ja yritysten tunnistautumis-APIa yrityskirjautumiseen ja käyttäjähallintaan. API-viite kattaa avustajien työkalut. MCP-opas kertoo, miten tekoälyavustajat löytävät ja käyttävät tuettuja työkaluja.
- **Voinko lukea API-määrityksiä ilman tiliä?:** Avustajatyökalujen, Yhteisö-APIn ja Toimittaja-APIn OpenAPI-määritykset ovat julkisia. Yritystunnistuksen määritys on suojattu. Julkisen määrityksen lukeminen ei anna oikeutta tehdä suojattuja pyyntöjä tai tilauksia.
- **Tarvitsenko kehittäjäintegraation tuotteen tilaamiseen?:** Et. Yksityishenkilöt, seurat ja yritykset voivat tutkia tuettuja tuotteita ja pyytää tarjouksen MerchandAisen sivustolla. API on valinnainen tapa yhdistää omat järjestelmäsi tai palvelusi.
- **Mitä integraatiopyyntöön kannattaa sisällyttää?:** Kerro käyttäjät, järjestelmät, luettavat tai päivitettävät tiedot ja tavoiteaikataulu. Lisää tiedossa olevat kirjautumis-, ympäristö- ja paluukutsuvaatimukset. Tiimi arvioi sopivan määrityksen ja käyttöoikeusmallin kanssasi.

## Suunnitteletko omaa integraatiota?
Kerro järjestelmät, haluamasi työnkulku ja käyttöönoton aikataulu. Autamme valitsemaan oikean määrityksen, käyttöoikeusmallin ja julkaisujärjestyksen.
- **Keskustele integraatiosta:** /fi/contact/integrations
- **Tutustu yritysratkaisuihin:** /fi/enterprise
