{"pageKey":"Developers","slug":"developers","locale":"fi","localeResolved":"fi","fallbackApplied":false,"version":"developers@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/fi/developers","payload":{"slug":"developers","purpose":"llm-developers","title":"Kehittäjä API, upotukset, MCP työkalut ja yritysintegraatiot | MerchandAise","description":"Tutustu räätälöityjen tuotteiden MerchandAise-kehittäjien sovellusliittymiin: OpenAPI-dokumentit, yhteisön upotukset, toimittajien työnkulku, yritysidentiteetti ja MCP-työkalut AI-agenteille.","sections":[{"heading":"Kehittäjäalusta","paragraphs":["Käytä MerchandAise-sovellusliittymiä, OpenAPI-sopimuksia, yhteisön upotuksia, toimittajien työnkulkuja, yritysidentiteettiä ja MCP-työkaluja liittääksesi mukautettuja tuotteita verkkosivustoihin, portaaleihin ja AI-agentteihin."]},{"heading":"Kuka rakentaa MerchandAise:lla","items":[{"title":"yhteisön toimijat","description":"Avaa upotetut julkisivut, konfiguraattorin kanavanvaihdot ja yhteisövirrat klubien, liigan ja yritysten sivustoilla versioiduilla julkisilla sopimuksilla."},{"title":"Yritystiimit ja alustakumppanit","description":"Yhdistä hankintaportaalit, identiteettijärjestelmät ja sisäiset toiminnot kauppatavaroiden työnkulkuihin ilman hyväksyntää ja toimittajalogiikkaa."},{"title":"AI agentti- ja automaatiorakentajat","description":"Anna avustajille strukturoidun työkalun käyttöoikeus etsintää, lainausta ja hyväksyttyjä toimintoja varten MCP-yhteensopivien päätepisteiden kautta."}]},{"heading":"Integrointipinnat ja sopimukset","items":[{"title":"API asiakirjat","description":"Tarkastele ihmisen luettavia asiakirjoja ja koneellisesti luettavia OpenAPI-sopimuksia suunnittelua, testausta ja versioiden hallintaa varten. Human guide: Read API docs (/fi/developers/api-integrations). Machine-readable contract: OpenAPI JSON (/api/docs/openapi.json). Access: public. Public reference for assistant and tooling APIs. Production access and order-affecting operations still require the applicable authorization. Canonical section: /developers#api-docs."},{"title":"Yhteisön upotus API","description":"Ota käyttöön kieliturvallisia myymälän upotuksia, yhteisön työnkulkuja ja todennettuja kanavanvaihtoja versioidulla julkisella sopimuksella. Human guide: Explore community workflows (/fi/developers/api-integrations#community-integrations). Machine-readable contract: Community OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. Public versioned contract for storefront embeds, community discovery, and locale-aware handoffs. Canonical section: /developers#community-integrations."},{"title":"Toimittaja API","description":"Yhdistä käyttöönotto-, luettelo- ja toimittajapuolen toiminnot versioiduilla päätepisteillä, jotka on suunniteltu toteutustyönkulkuja varten. Human guide: Explore partner workflow (/fi/developers/api-integrations#supplier-integrations). Machine-readable contract: Supplier OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. Public contract for planning and client generation. Operational supplier access remains permissioned. Canonical section: /developers#supplier-integrations."},{"title":"Yritystunnus API","description":"Integroi SSO, SCIM provisiointi ja tarkastusvalmiit identiteettivirrat yritysten käyttöönottoa ja hallintoa varten suojatulla sopimuksella hyväksyttyä yrityskäyttöä varten. Human guide: Explore enterprise platform (/fi/developers/api-integrations#enterprise-integrations). Machine-readable contract: Enterprise identity OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. Protected contract for approved enterprise workspaces; request access before using this endpoint. Canonical section: /developers#enterprise-integrations."},{"title":"MCP työkalut","description":"Paljasta hyväksytyt MerchandAise-ominaisuudet AI-agenteille löydettävien MCP-yhteensopivien työkalumääritelmien ja suorituksen päätepisteiden avulla, joissa on avustajan valtuutus. Human guide: Read MCP implementation guide (/fi/developers/ai-agents-mcp). Machine-readable contract: Public MCP server-card JSON (/fi/.well-known/mcp/server-card). Access: public. Public discovery document for machine clients. The external tools list at /api/v1/mcp/tools exposes current tool metadata; each tool call still follows its declared security, workspace, and confirmation boundaries. Canonical section: /developers#mcp-tools."}]},{"heading":"Integroinnin pikaopas","items":[{"title":"Step 1: Valitse työnkulkuasi vastaava sopimus","description":"Aloita alustalla, joka vastaa käyttäjä- ja todennusmalliasi: yhteisön upotus, yritysidentiteetti, toimittajatoiminnot tai MCP-työkalut avustajille."},{"title":"Step 2: Vahvista todennus-, versiointi- ja ympäristörajat","description":"Vahvista tarvittavat otsikot, laajuudet, takaisinsoitto-odotukset ja sopimusversiot vaiheittaisesti ennen tuotantoliikenteen reitittämistä."},{"title":"Step 3: Testaa päästä päähän työnkulkuja ennen julkaisua","description":"Tarkista pyynnöt, webhookit, hallinta, tarkkailtavuus ja palautuspolut, jotta integrointi on luotettavaa ensimmäisestä käyttökerrasta lähtien."}]},{"heading":"What production-ready means","paragraphs":["A production integration needs more than a public endpoint. Use these gates to decide whether your workflow is ready for customer, supplier, enterprise, or AI-agent traffic."],"items":[{"title":"Sandbox and access review","description":"Confirm which contracts are public, which enterprise surfaces require approval, and which credentials or workspace roles are needed before launch."},{"title":"Versioned implementation evidence","description":"Keep generated clients, callback URLs, auth scopes, contract versions, and rollback ownership documented before production traffic is enabled."},{"title":"Operational observability","description":"Plan logs, retries, support ownership, failure states, and health checks for every workflow that can affect an order, supplier, or enterprise user."}]},{"heading":"Tarvitsetko integraatiotarkistuksen?","paragraphs":["Jaa arkkitehtuurisi, käyttöönottoaikajanasi ja kohdekanavasi. Suosittelemme oikeaa sopimuspintaa, todennusmallia ja käynnistysjärjestystä."],"items":[{"title":"Keskustele integraatiotiimin kanssa","description":"/fi/contact/integrations"},{"title":"Tutustu yritysalustaan","description":"/fi/enterprise"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}