# 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: Lue API-asiakirjat (/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: /fi/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. Julkinen versioinen sopimus myymälän upottamisesta, yhteisön löytämisestä ja aluetietoisista kanavanvaihdoista. Canonical section: /fi/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. Julkinen sopimus suunnittelusta ja asiakastuonnista. Toimittajien käyttöoikeus on edelleen sallittu. Canonical section: /fi/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. Suojattu sopimus hyväksyttyjä yrityksen työtiloja varten; pyydä käyttöoikeutta ennen tämän päätepisteen käyttöä. Canonical section: /fi/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: Lue MCP-käyttöopas (/fi/developers/ai-agents-mcp). Machine-readable contract: Public MCP server-card JSON (/.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: /fi/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
Tuotantointegraatio tarvitsee muutakin kuin julkisen päätepisteen. Käytä näitä portteja päättääksesi, onko työnkulkusi valmis asiakas-, toimittaja-, yritys- tai tekoälyagenttiliikenteeseen.
- **Sandbox and access review:** Varmista ennen julkaisua, mitkä sopimukset ovat julkisia, mitkä yrityspinnat vaativat hyväksynnän ja mitkä tunnistetiedot tai työtilaroolit tarvitaan.
- **Versioned implementation evidence:** Pidä luodut asiakkaat, takaisinkutsun URL-osoitteet, todennusalueet, sopimusversiot ja palautusomistus dokumentoituina ennen kuin tuotantoliikenne otetaan käyttöön.
- **Operational observability:** Suunnittele lokit, uudelleenyritykset, tuen omistajuus, vikatilat ja kuntotarkistukset jokaiselle työnkululle, joka voi vaikuttaa tilaukseen, toimittajaan tai yrityskäyttäjään.

## 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