{"pageKey":"Developers","slug":"developers","locale":"fi","localeResolved":"fi","fallbackApplied":false,"version":"developers@2026-11-22T04:58:30.053Z","lastModified":null,"canonicalUrl":"https://www.merchandaise.com/fi/developers","payload":{"slug":"developers","purpose":"llm-developers","title":"Kehittäjäkeskus: tuote-API:t, OpenAPI ja MCP | MerchandAise","description":"Rakenna personoitujen tuotteiden integraatioita MerchandAisen rajapinnoilla. Tutustu OpenAPI-ohjeisiin, yhteisöupotuksiin, toimittajien työnkulkuihin, yritysten SSO:hon ja MCP-työkaluihin.","sections":[{"heading":"MerchandAisen kehittäjäkeskus","paragraphs":["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."]},{"heading":"Tuoteprojektisi ympärillä oleville järjestelmille","items":[{"title":"Yhteisöjen ylläpitäjät","description":"Toteuta upotetut kaupat, siirtymät konfiguraattoriin ja yhteisöjen työnkulut seurojen, liigojen ja yritysten sivustoilla versioitujen julkisten määritysten avulla."},{"title":"Yritystiimit ja alustakumppanit","description":"Yhdistä hankintaportaalit, tunnistusjärjestelmät ja sisäinen toiminta tuoteprosessiin rakentamatta hyväksyntä- ja toimittajalogiikkaa uudelleen."},{"title":"Tekoälyagenttien ja automaatioiden kehittäjät","description":"Anna avustajille rakenteinen työkalujen käyttöoikeus löytämiseen, tarjouksiin ja hyväksyttyihin toimintoihin MCP-yhteensopivien päätepisteiden kautta."}]},{"heading":"Löydä integraatiosi","items":[{"title":"API-dokumentaatio ja OpenAPI","description":"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."},{"title":"Yhteisö-API","description":"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."},{"title":"Toimittaja-API","description":"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."},{"title":"Yritysten tunnistautumis-API","description":"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."},{"title":"Tekoälyagentit ja MCP","description":"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."}]},{"heading":"Ensimmäisestä pyynnöstä tuotantoon","items":[{"title":"Vaihe 1: Valitse työnkulkuusi sopiva määritys","description":"Aloita käyttäjääsi ja valtuutusmalliasi vastaavasta rajapinnasta: yhteisöupotus, yritystunnistus, toimittajatoiminnot tai avustajien MCP-työkalut."},{"title":"Vaihe 2: Vahvista tunnistautuminen, versiointi ja ympäristörajat","description":"Vahvista vaaditut otsakkeet, käyttöoikeusalueet, paluukutsujen odotukset ja määritysversiot testiympäristössä ennen tuotantoliikenteen ohjaamista."},{"title":"Vaihe 3: Testaa koko työnkulku ennen julkaisua","description":"Vahvista pyynnöt, webhookit, käyttäjähallinta, havainnoitavuus ja palautuspolut, jotta integraatio on luotettava ensimmäisestä tuotantokäytöstä lähtien."}]},{"heading":"Mitä tuotantovalmius tarkoittaa","paragraphs":["Tuotantointegraatio vaatii enemmän kuin julkisen päätepisteen. Arvioi näiden tarkistusten avulla, onko työnkulku valmis asiakkaiden, toimittajien, yritysten tai tekoälyagenttien liikenteelle."],"items":[{"title":"Testiympäristön ja käyttöoikeuksien arviointi","description":"Vahvista ennen julkaisua, mitkä määritykset ovat julkisia, mitkä yritysrajapinnat vaativat hyväksynnän ja mitä tunnistetietoja tai työtilarooleja tarvitaan."},{"title":"Versioidun toteutuksen näyttö","description":"Dokumentoi generoidut asiakasohjelmat, paluukutsuosoitteet, käyttöoikeusalueet, määritysversiot ja palautuksesta vastaava taho ennen tuotantoliikenteen sallimista."},{"title":"Toiminnan seurattavuus","description":"Suunnittele lokit, uudelleenyritykset, tukivastuut, virhetilat ja terveystarkistukset jokaiselle tilaukseen, toimittajaan tai yrityskäyttäjään vaikuttavalle työnkululle."}]},{"heading":"Ennen kehittämisen aloittamista","items":[{"title":"Mitä MerchandAisen APIa minun kannattaa käyttää?","description":"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."},{"title":"Voinko lukea API-määrityksiä ilman tiliä?","description":"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."},{"title":"Tarvitsenko kehittäjäintegraation tuotteen tilaamiseen?","description":"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."},{"title":"Mitä integraatiopyyntöön kannattaa sisällyttää?","description":"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."}]},{"heading":"Suunnitteletko omaa integraatiota?","paragraphs":["Kerro järjestelmät, haluamasi työnkulku ja käyttöönoton aikataulu. Autamme valitsemaan oikean määrityksen, käyttöoikeusmallin ja julkaisujärjestyksen."],"items":[{"title":"Keskustele integraatiosta","description":"/fi/contact/integrations"},{"title":"Tutustu yritysratkaisuihin","description":"/fi/enterprise"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"route-owned-source","schema":"2025-11-05"}}