# Meenete API ja liidestuslepingud | MerchandAise

- slug: developers-api-integrations
- locale: et
- localeResolved: et
- canonical: https://www.merchandaise.com/et/developers/api-integrations

Tutvuge MerchandAise'i lepingutega assistenditööriistade, kogukonna pesade, tarnijate tegevuste ja ettevõtte identiteedi jaoks koos selgete avalike ja kaitstud juurdepääsupiiridega.

## Säilitage üks tõeallikas
Liidestus peaks MerchandAise'i töövoogu laiendama, mitte seda harundama. Veebileht, pesa, tarnija, ettevõtte ja tulevased assistendi liidesed peavad lugema ja värskendama sama versioonitud disaini, ostusoovi, hinnapakkumise, kinnituse ja tellimuse olekut.
Kui MerchandAise töötleb ostja tehingut, on Hutter Products GmbH lepinguline müüja ja vastutav kaupmees (Merchant of Record) MerchandAise'i kaubamärgi all. Tarnija identiteet ja kontaktandmed jäävad konfidentsiaalseks, välja arvatud seadusega nõutud juhtudel, ning tootmine eeldab endiselt digitaalse proovi ja füüsilise näidise heakskiitmist.

## API ja liidestamise valdkonnad
- **Assistenditööriistade API dokumendid:** Tutvuge praeguste assistendi ja tööriistade otspunktidega disainisessioonide ning liidestuse ülevaatuse jaoks. See avalik viide ei anna anonüümset õigust hinnapakkumiste tegemiseks ega tellimuste esitamiseks. Human guide: Ava assistenditööriistade dokumendid (/et/developers/api-integrations). Machine-readable contract: Assistenditööriistade OpenAPI JSON (/api/docs/openapi.json). Access: public. Avalik viide assistendi ja tööriistade API-dele. Tootmispääs ja tellimusi mõjutavad toimingud nõuavad endiselt vastavat autoriseerimist. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs.
- **Kogukonna pesa API:** Ühendage lokaliseeritud klubi, kogukonna või e-poe kogemused MerchandAise'i hallatavate disaini- ja ostuüleminekutega ilma põhilist töövoogu uuesti üles ehitamata. Human guide: Vaata kogukonna liidestamise juhendit (/et/developers/api-integrations#community-integrations). Machine-readable contract: Kogukonna OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. Avalik versioonitud leping e-poe pesade, kogukonna avastamise ja lokaaditundlike üleminekute jaoks. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations.
- **Tarnija API:** Ühendage heakskiidetud tarnijad liitumis-, kataloogi-, hinnapakkumis- ja täitetoimingutega pärast tarnijasuhte ja juurdepääsumudeli kinnitamist. Human guide: Vaata tarnija liidestamise juhendit (/et/developers/api-integrations#supplier-integrations). Machine-readable contract: Tarnija OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. Avalik leping planeerimiseks ja kliendikoodi genereerimiseks. Operatiivne juurdepääs tarnijale on endiselt õigustepõhine. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations.
- **Ettevõtte identiteedi API:** Planeerige SSO, SCIM-i kasutajahaldus ja auditeerimisvalmis identiteedivood heakskiidetud ettevõtte meeneprogrammide ja hallatavate juurutuste jaoks. Human guide: Vaata ettevõtte liidestamise juhendit (/et/developers/api-integrations#enterprise-integrations). Machine-readable contract: Ettevõtte identiteedi OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. Kaitstud leping heakskiidetud ettevõtte tööruumidele; taotlege juurdepääsu enne selle otspunkti kasutamist. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

## Valige leping enne koodi kirjutamist
- **Step 1: Kaardistage kasutajateekond:** Otsustage, kes ja kus töövoogu siseneb: ostja liidetud e-poes, heakskiidetud tarnija, ettevõtte kasutaja või selgesõnalise volitusega tegutsev assistent.
- **Step 2: Kinnitage juurdepääsupiir:** Kasutage hindamiseks ja kliendikoodi genereerimiseks avalikke lepinguid, seejärel kinnitage enne rakendamist mandaadid, õigused, keskkonnad, tagasikutsed ja kaitstud otspunktid.
- **Step 3: Tõendage oleku järjepidevus:** Testige, et disainilahendused, hinnapakkumised, kinnitused, vead ja tellimuste üleminekud säilitaksid kogu liidestuse vältel õige versiooni, sealhulgas korduskatsete ja tagasivõtmiste puhul.

## Mida iga liidestus peab säilitama
- **Üks versioonitud olek:** Disain, ostusoov, tarnija tagatud hinnapakkumine, kinnitus ja tellimuse olek jäävad seotuks. Aegunud muudatused peavad käivitama nähtava uue hinnapakkumise või ülevaatuse oleku.
- **Äri- ja tarnijasaladus:** MerchandAise jääb ostja poole suunatud kaupmeheks ja klienditoe omanikuks. Tarnijate identiteete, kontakte ja siseandmeid avalike liidestuste kaudu ei paljastata.
- **Kinnitamine enne tootmist:** Tootepõhine 3D-vaade ja digitaalne proov toetavad otsust, kuid need ei asenda füüsilist tootmisnäidist, mis on vajalik enne masstootmist.

## Enne tootmisliiklust
Avaldatud OpenAPI-fail on planeerimisvahend, mitte lubadus anonüümseks tootmispääsuks. Enne avalikustamist vaatame üle keskkonnad, mandaadid, tõrgete käsitlemise ja operatiivse vastutuse.
- **Juurdepääs ja keskkonnad:** Kinnitage lepingu versioon, heakskiidetud tööruum, autentimisõigused, liivakast, tootmismandaadid ja tagasikutsete sihtkohad.
- **Tõrked ja taastamine:** Määratlege enne väljalaset korduskatsed, idempotentsus, ajalõpud, kliendile nähtavad vead, jälgitavus, toe vastutus ja tagasivõtmine.
- **Täielik tõendusmaterjal:** Kontrollige kavandatud teekonda testkeskkonnas alates sisenemisest ja oleku muutmisest kuni hinnapakkumise, kinnituse, üleandmise ja taastamiskäitumiseni.

## KKK
- **Millise liidestusega peaksin alustama?:** Alustage kasutajast ja oleku üleminekust. Kasutage kogukonna pesasid ostjale suunatud klubi- või kogukonnateekondade jaoks, tarnija tegevusi heakskiidetud tarnijapoolsete töövoogude jaoks, ettevõtte identiteeti SSO ja SCIM-i jaoks ning assistenditööriistu ainult selgesõnaliselt volitatud AI-põhiste voogude jaoks.
- **Kas avalik leping tähendab avalikku juurdepääsu tootmiskeskkonnale?:** Ei. Avalik OpenAPI-leping toetab avastamist, arhitektuuri ülevaatust ja kliendikoodi genereerimist. Tootmismandaadid, kirjutustoimingud, tarnijate töövood, ettevõtte identiteet ja assistendi käivitamine võivad siiski nõuda heakskiidetud tööruumi ja piiratud õigustega autoriseerimist.
- **Kas liidestus võib tarnijaid paljastada või kinnitustest mööda minna?:** Ei. Tarnija identiteet ja kontaktandmed jäävad konfidentsiaalseks, välja arvatud seadusega nõutud juhtudel, MerchandAise omab suhet ostjaga ning tellimusi mõjutavad toimingud peavad säilitama seadistatud kinnitus- ja füüsilise näidise etapid.

## Tooge meile töövoog, mitte valmis arhitektuur.
Öelge meile, kes liidestust kasutab, millist olekut on vaja lugeda või muuta ning kus see kogemus asuma hakkab. Kaardistame koos teiega lepingu, juurdepääsumudeli ja turvalisima juurutustee.
- **Planeeri liidestus:** /et/contact?intent=api-integration-review
- **Tutvu AI-agentide ja MCP-ga:** /et/developers/ai-agents-mcp