# Kehittäjä API, upotukset, MCP työkalut ja yritysintegraatiot | MerchandAise

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

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.

## Kehittäjäalusta
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.

## Kuka rakentaa MerchandAise:lla
- **yhteisön toimijat:** Avaa upotetut julkisivut, konfiguraattorin kanavanvaihdot ja yhteisövirrat klubien, liigan ja yritysten sivustoilla versioiduilla julkisilla sopimuksilla.
- **Yritystiimit ja alustakumppanit:** Yhdistä hankintaportaalit, identiteettijärjestelmät ja sisäiset toiminnot kauppatavaroiden työnkulkuihin ilman hyväksyntää ja toimittajalogiikkaa.
- **AI agentti- ja automaatiorakentajat:** Anna avustajille strukturoidun työkalun käyttöoikeus etsintää, lainausta ja hyväksyttyjä toimintoja varten MCP-yhteensopivien päätepisteiden kautta.

## Integrointipinnat ja sopimukset
- **API asiakirjat:** 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.
- **Yhteisön upotus API:** 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.
- **Toimittaja API:** 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.
- **Yritystunnus API:** 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.
- **MCP työkalut:** 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.

## Integroinnin pikaopas
- **Step 1: Valitse työnkulkuasi vastaava sopimus:** Aloita alustalla, joka vastaa käyttäjä- ja todennusmalliasi: yhteisön upotus, yritysidentiteetti, toimittajatoiminnot tai MCP-työkalut avustajille.
- **Step 2: Vahvista todennus-, versiointi- ja ympäristörajat:** Vahvista tarvittavat otsikot, laajuudet, takaisinsoitto-odotukset ja sopimusversiot vaiheittaisesti ennen tuotantoliikenteen reitittämistä.
- **Step 3: Testaa päästä päähän työnkulkuja ennen julkaisua:** Tarkista pyynnöt, webhookit, hallinta, tarkkailtavuus ja palautuspolut, jotta integrointi on luotettavaa ensimmäisestä käyttökerrasta lähtien.

## What production-ready means
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.
- **Sandbox and access review:** Confirm which contracts are public, which enterprise surfaces require approval, and which credentials or workspace roles are needed before launch.
- **Versioned implementation evidence:** Keep generated clients, callback URLs, auth scopes, contract versions, and rollback ownership documented before production traffic is enabled.
- **Operational observability:** Plan logs, retries, support ownership, failure states, and health checks for every workflow that can affect an order, supplier, or enterprise user.

## Tarvitsetko integraatiotarkistuksen?
Jaa arkkitehtuurisi, käyttöönottoaikajanasi ja kohdekanavasi. Suosittelemme oikeaa sopimuspintaa, todennusmallia ja käynnistysjärjestystä.
- **Keskustele integraatiotiimin kanssa:** /fi/contact/integrations
- **Tutustu yritysalustaan:** /fi/enterprise