# Prekių API dokumentai ir OpenAPI integracijos | MerchandAise

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

Naršykite MerchandAise API dokumentus ir OpenAPI specifikacijas, skirtas pritaikytoms prekėms, bendruomenės įterpimams, tiekėjų darbo eigoms ir įmonės tapatybei.

## Pasirinkite jūsų projektui reikalingą ryšį
Naudokite toliau pateiktas nuorodas, kad įvertintumėte galutinius taškus, užklausų formatus ir autorizacijos reikalavimus. Viešosios specifikacijos palaiko planavimą ir klientų generavimą; operacinė prieiga priklauso nuo API, paskyros ir aplinkos.
Kai MerchandAise apdoroja pirkėjo operaciją, Hutter Products GmbH yra sutartį sudarantis pardavėjas ir prekybininkas su prekės ženklu MerchandAise. Tiekėjo tapatybė ir kontaktiniai duomenys lieka privatūs, išskyrus atvejus, kai būtina atskleisti, o gamybai vis tiek reikalingas skaitmeninio spaudinio maketo patvirtinimas, patvirtintas produktyvumas, privalomos techninės patikros ir tiksliai priimtam užsakymui taikomi patvirtinimų pavyzdžiai.

## API ir integravimo paviršiai
- **API dokumentai ir OpenAPI:** Raskite API nuorodą, skirtą asistento įrankių ir projektavimo seansams, tada pasirinkite savo darbo eigos bendruomenės, tiekėjo ar įmonės sutartį. Įgyvendinimo vadovas: Skaitykite asistento įrankių dokumentus (/api/docs). Mašinos sutartis: Asistento įrankis OpenAPI JSON (/api/docs/openapi.json). Prieiga: Viešas. Vieša asistento ir įrankių API nuoroda. Prieigai prie gamybos ir užsakymams įtakos turinčioms operacijoms vis tiek reikalingas atitinkamas leidimas. Kanoninis puslapis: /lt/developers/api-integrations. Kanoninis skyrius: /lt/developers/api-integrations#api-docs.
- **Bendruomenių API:** Prijunkite klubo ar bendruomenės svetainę prie viešos bendruomenės informacijos, dizaino pateikimo, balsavimo ir užsakymo patvirtinimo. Ką apima sutartis: Viešas bendruomenės kontekstas, dizaino įrašai ir balsai, sąrašo paskelbimas, laukiantys užsakymai ir bendruomenės savininko patvirtinimas arba atmetimas. Praktinis atspirties taškas: Skaitykite viešą klubo svetainės bendruomenės kontekstą. Tada nustatykite, kuriems veiksmams reikia nario seanso arba savininko leidimų, prieš pridėdami dizaino pateikimo ar patikros perdavimo. Prieiga: Specifikacija yra vieša. Viešam skaitymui, narių veiksmams ir tik savininko operacijoms taikomi skirtingi leidimo reikalavimai; naudokite saugos taisykles kiekviename galutiniame taške. Įgyvendinimo vadovas: Naršykite bendruomenės API (/lt/developers/api-integrations#community-integrations). Mašinos sutartis: Bendruomenės OpenAPI JSON (/api/v1/community/public/openapi/v1). Prieiga: Viešas. Viešos versijos sutartis dėl parduotuvės vitrinos įterpimo, bendruomenės atradimo ir vietos perdavimo. Kanoninis puslapis: /lt/developers/api-integrations. Kanoninis skyrius: /lt/developers/api-integrations#community-integrations.
- **Tiekėjų API:** Prijunkite patvirtintas tiekėjų sistemas prie išleistų gamybos paketų, įjungimo būsenos ir ERP arba PLM webhook darbo eigos. Ką apima sutartis: Tiekėjo prisijungimo būsena, išleisti gamybos paketai, tikrinti artefaktų atsisiuntimai, analizė, „Webhook“ prenumeratos ir sinchronizavimo patikros taškai. Praktinis atspirties taškas: Suplanuokite ryšį tarp savo ERP arba produkto gyvavimo ciklo valdymo sistemos ir Tiekėjų centro. Prieš vykdydami priskirtą užsakymą, peržiūrėkite „Webhook“ naudingąsias apkrovas, pakartotinius bandymus ir sinchronizavimo būseną. Prieiga: Perskaitykite OpenAPI specifikaciją neprisijungę. Operacinėms užklausoms reikalinga atitinkama tiekėjo paskyra ir leidimai; vieši dokumentai neįregistruoja tiekėjo ir nesuteikia prieigos prie kito tiekėjo duomenų. Įgyvendinimo vadovas: Naršykite Tiekėjo API (/lt/developers/api-integrations#supplier-integrations). Mašinos sutartis: Tiekėjas OpenAPI JSON (/api/v1/supplier/openapi/v1). Prieiga: Viešas. Planavimo ir klientų generavimo viešoji sutartis. Operatyvaus tiekėjo prieiga išlieka leidžiama. Kanoninis puslapis: /lt/developers/api-integrations. Kanoninis skyrius: /lt/developers/api-integrations#supplier-integrations.
- **Įmonių tapatybės API:** Prijunkite patvirtintas įmonės darbo sritis prie vieno prisijungimo, naudotojo ir grupės aprūpinimo ir tapatybės audito įrašų. Ką apima sutartis: OpenID Connect (OIDC) vienkartinis prisijungimas, SCIM vartotojo ir grupės gyvavimo ciklo operacijos, SCIM prieigos rakto kaitaliojimas ir aprūpinimo audito įvykiai. Praktinis atspirties taškas: Susiekite savo tapatybės teikėją su patvirtinta darbo vieta. Suplanuokite prisijungimą, naudotojų aprūpinimą ir atšaukimą, tada patikrinkite grupių susiejimą ir audito įrašus sutartoje bandymo aplinkoje. Prieiga: Įmonės tapatybės specifikacija yra apsaugota. Prieš diegdami susisiekite su integravimo komanda, kad peržiūrėtumėte darbo sritį ir prieigos reikalavimus. Įmonės tapatybė yra neprivaloma perkant įprastus produktus. Įgyvendinimo vadovas: Ištirkite įmonės tapatybę (/lt/developers/api-integrations#enterprise-integrations). Mašinos sutartis: Įmonės tapatybė OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Prieiga: Apsaugotas. Apsaugota sutartis dėl patvirtintų įmonės darbo vietų; prieš naudodami šį galinį tašką paprašykite prieigos. Kanoninis puslapis: /lt/developers/api-integrations. Kanoninis skyrius: /lt/developers/api-integrations#enterprise-integrations.

## Prieš kodą pasirinkite sutartį
- **Žingsnis 1: Nubrėžkite vartotojo kelionę:** Nuspręskite, kas ir kur įsijungs į darbo eigą: pirkėjas įterptoje parduotuvėje, patvirtintas tiekėjas, įmonės vartotojas ar asistentas, dirbantis su aišku leidimu.
- **Žingsnis 2: Patvirtinkite prieigos ribą:** Įvertinimui ir klientų generavimui naudokite viešąsias sutartis, tada prieš įdiegdami patvirtinkite kredencialus, apimtis, aplinkas, atgalinius iškvietimus ir apsaugotus galinius taškus.
- **Žingsnis 3: Įrodykite būsenos tęstinumą:** Patikrinkite, ar dizainas, komerciniai pasiūlymai, patvirtinimai, klaidos ir užsakymų perdavimas išliks naujausios versijos integracijos metu, įskaitant bandymus ir atšaukimo kelius.

## Ką turi išsaugoti kiekviena integracija
- **Viena versijų būsena:** Palaikykite ryšį su dizainu, komerciniais tikslais, tiekėjų remiamu komerciniu pasiūlymu, patvirtinimu ir užsakymo būsena. Pasenę pakeitimai turi suaktyvinti matomą pakartotinį komercinį pasiūlymą arba peržiūros būseną.
- **Komercinis ir tiekėjų privatumas:** MerchandAise išlieka pirkėjui skirtas prekybininkas ir pagalbos savininkas. Tiekėjo tapatybės, kontaktai ir vidiniai duomenys nėra atskleisti viešai integruojant.
- **Patvirtinimas prieš gamybą:** 3D vaizdas nėra fizinis įrodymas. Patvirtintame komerciniame pasiūlyme paaiškinami visi galimi klientų pasirinkimai, išlaidos, apribojimai ir laikas. Prieš masinę gamybą patvirtinkite tikslų skaitmeninio spaudinio maketą ir atlikite privalomus techninius patikrinimus bei bet kokį reikalaujamą arba pasirinktą pavyzdį. Esami priimtų užsakymų reikalavimai išlieka privalomi.

## Prieš gamybos srautą
Paskelbtas OpenAPI failas yra planavimo paviršius, o ne anoniminės gamybos prieigos pažadas. Prieš pradedant eksploatuoti, peržiūrime aplinką, kredencialus, gedimų apdorojimą ir veiklos nuosavybę.
- **Prieiga ir aplinka:** Patvirtinkite sutarties versiją, patvirtintą darbo sritį, autentifikavimo apimtis, smėlio dėžę, gamybos kredencialus ir atgalinio skambinimo paskirties vietas.
- **Nesėkmė ir atsigavimas:** Apibrėžkite pakartotinius bandymus, idempotenciją, skirtąjį laiką, klientų matomas klaidas, stebimumą, palaikymo nuosavybės teisę ir atšaukimą prieš išleidimą.
- **Nuo galo iki galo įrodymai:** Patikrinkite numatytą kelionę nuo įėjimo ir būsenos mutacijos iki komercinio pasiūlymo, patvirtinimo, perdavimo ir atkūrimo veiksmų.

## DUK
- **Nuo kurios prekių API turėčiau pradėti?:** Pradėkite nuo asmens ir būsenos perėjimo. Naudokite bendruomenės įterpimus pirkėjo klubo ar bendruomenės kelionėms, tiekėjų operacijoms patvirtintoms tiekimo pusės darbo eigoms, įmonės tapatybei SSO ir SCIM ir pagalbinius įrankius tik aiškiai įgaliotiems dirbtinio intelekto srautams.
- **Ar viešoji sutartis reiškia viešąją prieigą prie produkcijos?:** Ne. Vieša OpenAPI sutartis palaiko atradimą, architektūros peržiūrą ir klientų generavimą. Gamybos kredencialams, rašymo operacijoms, tiekėjo darbo eigoms, įmonės tapatybei ir pagalbiniam vykdymui vis tiek gali prireikti patvirtintos darbo srities ir aprėptos prieigos teisės.
- **Ar integracija gali atskleisti tiekėjus arba apeiti patvirtinimus?:** Ne. Tiekėjo tapatybė ir kontaktiniai duomenys lieka privatūs, išskyrus atvejus, kai reikia atskleisti, MerchandAise priklauso pirkėjo santykiai, o užsakymui įtakos turintys veiksmai turi išlaikyti sukonfigūruotą skaitmeninio spausdinimo maketą, techninius ir konkrečių užsakymų pavyzdžių patvirtinimo reikalavimus.

## Suplanuokite savo integraciją su mumis.
Papasakokite, kas naudos integraciją, kurią būseną jiems reikia perskaityti ar pakeisti ir kur bus ši patirtis. Su jumis sudarysime sutartį, prieigos modelį ir saugiausią diegimo kelią.
- **Suplanuokite integraciją:** /lt/contact?intent=api-integration-review
- **Naršykite AI agentus ir MCP:** /lt/developers/ai-agents-mcp
