# Termék-API-dokumentáció és OpenAPI-integrációk | MerchandAise

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

Fedezze fel a MerchandAise API-dokumentációját és OpenAPI-specifikációit egyedi termékekhez, közösségi beágyazásokhoz, beszállítói folyamatokhoz és vállalati azonosításhoz.

## Válassza a projektjéhez szükséges kapcsolatot
Az alábbi referenciákkal vizsgálja meg a végpontokat, kérésformátumokat és jogosultsági követelményeket. A nyilvános specifikációk tervezést és kliensgenerálást támogatnak; a működési hozzáférés az API-tól, fióktól és környezettől függ.
Ahol a MerchandAise dolgozza fel a vásárlói tranzakciót, a Hutter Products GmbH a szerződő eladó és a Merchant of Record a MerchandAise márkanév alatt. A beszállítói kilét és elérhetőségek bizalmasak maradnak az előírt közlések kivételével. A gyártáshoz továbbra is szükséges a digitális látványterv jóváhagyása, megerősített gyárthatóság, kötelező műszaki ellenőrzések és az adott elfogadott rendelésre vonatkozó mintajóváhagyások.

## API- és integrációs felületek
- **API-dokumentáció és OpenAPI:** Keresse meg az asszisztenseszközök és tervezési munkamenetek API-referenciáját, majd válassza ki a folyamatához illő közösségi, beszállítói vagy vállalati szerződést. Megvalósítási útmutató: Asszisztenseszközök dokumentációja (/api/docs). Géppel olvasható specifikáció: Asszisztenseszközök OpenAPI JSON (/api/docs/openapi.json). Hozzáférés: Nyilvános. Nyilvános referencia az asszisztens- és eszköz-API-khoz. Az éles hozzáféréshez és rendelést érintő műveletekhez továbbra is szükséges a megfelelő jogosultság. Canonical page: /hu/developers/api-integrations. Kanonikus szakasz: /hu/developers/api-integrations#api-docs.
- **Közösségi API:** Kapcsoljon klub- vagy közösségi weboldalt a nyilvános közösségi adatokhoz, tervbeküldéshez, szavazáshoz és rendelésjóváhagyási átadásokhoz. A szerződés tartalma: Nyilvános közösségi környezet, tervbejegyzések és szavazatok, listázások közzététele, függő rendelések és közösségtulajdonosi jóváhagyás vagy elutasítás. Gyakorlati kiindulópont: Olvasson nyilvános közösségi adatokat egy klub weboldalához. Tervbeküldés vagy pénztári átadás hozzáadása előtt határozza meg, mely műveletek igényelnek tagi munkamenetet vagy tulajdonosi jogosultságot. Hozzáférés: A specifikáció nyilvános. A nyilvános olvasások, tagi és tulajdonosi műveletek eltérő jogosultsági követelményekkel járnak; kövesse az egyes végpontok biztonsági szabályait. Megvalósítási útmutató: Közösségi API felfedezése (/hu/developers/api-integrations#community-integrations). Géppel olvasható specifikáció: Közösségi OpenAPI JSON (/api/v1/community/public/openapi/v1). Hozzáférés: Nyilvános. Nyilvános, verziózott szerződés boltbeágyazásokhoz, közösségfelfedezéshez és nyelvérzékeny átadásokhoz. Canonical page: /hu/developers/api-integrations. Kanonikus szakasz: /hu/developers/api-integrations#community-integrations.
- **Beszállítói API:** Kapcsoljon jóváhagyott beszállítói rendszereket kiadott gyártási csomagokhoz, belépési állapothoz és ERP- vagy PLM-webhook-folyamatokhoz. A szerződés tartalma: Beszállítói belépési állapot, kiadott gyártási csomagok, naplózott fájlletöltések, elemzések, webhook-feliratkozások és szinkronizálási ellenőrzőpontok. Gyakorlati kiindulópont: Tervezze meg ERP- vagy termékéletciklus-kezelő rendszerének kapcsolatát a Beszállítói központtal. Kiosztott rendelés kezelése előtt tekintse át a webhook-adatokat, újrapróbálkozásokat és szinkronizálási állapotot. Hozzáférés: Az OpenAPI-specifikáció bejelentkezés nélkül olvasható. A működési kérések megfelelő beszállítói fiókot és jogosultságot igényelnek; a nyilvános dokumentáció nem regisztrál beszállítót, és nem ad hozzáférést más beszállító adataihoz. Megvalósítási útmutató: Beszállítói API felfedezése (/hu/developers/api-integrations#supplier-integrations). Géppel olvasható specifikáció: Beszállítói OpenAPI JSON (/api/v1/supplier/openapi/v1). Hozzáférés: Nyilvános. Nyilvános szerződés tervezéshez és kliensgeneráláshoz. A működési beszállítói hozzáférés továbbra is engedélyhez kötött. Canonical page: /hu/developers/api-integrations. Kanonikus szakasz: /hu/developers/api-integrations#supplier-integrations.
- **Vállalati azonosítási API:** Kapcsoljon jóváhagyott céges munkaterületeket egyszeri bejelentkezéshez, felhasználó- és csoportkezeléshez és azonosítási naplókhoz. A szerződés tartalma: OpenID Connect (OIDC) egyszeri bejelentkezés, SCIM felhasználó- és csoportéletciklus-műveletek, SCIM-tokenek cseréje és felhasználókezelési naplóesemények. Gyakorlati kiindulópont: Képezze le azonosítási szolgáltatóját a jóváhagyott munkaterületre. Tervezze meg a bejelentkezést, felhasználók létrehozását és eltávolítását, majd ellenőrizze a csoportleképezéseket és naplókat az egyeztetett tesztkörnyezetben. Hozzáférés: A vállalati azonosítási specifikáció védett. Megvalósítás előtt az integrációs csapattal vizsgálja meg a munkaterületet és hozzáférési követelményeket. A vállalati azonosítás a szokásos termékvásárláshoz nem kötelező. Megvalósítási útmutató: Vállalati azonosítás felfedezése (/hu/developers/api-integrations#enterprise-integrations). Géppel olvasható specifikáció: Vállalati azonosítás OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Hozzáférés: Védett. Védett szerződés jóváhagyott vállalati munkaterületeknek; a végpont használata előtt kérjen hozzáférést. Canonical page: /hu/developers/api-integrations. Kanonikus szakasz: /hu/developers/api-integrations#enterprise-integrations.

## Előbb a szerződést válassza, aztán a kódot
- **Lépés 1: Képezze le a felhasználói utat:** Döntse el, ki és hol lép a folyamatba: vásárló beágyazott boltban, jóváhagyott beszállító, vállalati felhasználó vagy kifejezett jogosultsággal működő asszisztens.
- **Lépés 2: Erősítse meg a hozzáférési határt:** Használjon nyilvános szerződéseket értékeléshez és kliensgeneráláshoz, majd megvalósítás előtt erősítse meg a hitelesítő adatokat, jogosultsági köröket, környezeteket, callbackeket és védett végpontokat.
- **Lépés 3: Igazolja az állapot folytonosságát:** Tesztelje, hogy a tervek, ajánlatok, jóváhagyások, hibák és rendelési átadások az integrációban aktuális verzión maradnak-e, beleértve az újrapróbálkozási és visszaállítási utakat.

## Amit minden integrációnak meg kell őriznie
- **Egy verziózott állapot:** A terv, vásárlási szándék, beszállító által alátámasztott ajánlat, jóváhagyás és rendelési állapot összekapcsolva marad. Elavult módosításnak látható újraajánlást vagy ellenőrzési állapotot kell kiváltania.
- **Kereskedelmi és beszállítói adatvédelem:** A vásárlóval szembeni kereskedői és támogatási felelősség a MerchandAise-é marad. A beszállítói kilét, elérhetőségek és belső adatok nyilvános integrációkon nem válnak hozzáférhetővé.
- **Jóváhagyás gyártás előtt:** A 3D-nézet nem fizikai bizonyíték. A megerősített ajánlat ismerteti az elérhető ügyfélminta-lehetőségeket, költségeket, korlátozásokat és időzítést. Sorozatgyártás előtt hagyja jóvá a pontos digitális látványtervet, végezze el a kötelező műszaki ellenőrzéseket, és hagyja jóvá az előírt vagy kiválasztott mintát. A már elfogadott rendelések követelményei továbbra is kötelezőek.

## Éles forgalom előtt
Egy közzétett OpenAPI-fájl tervezési felület, nem ígéret névtelen éles hozzáférésre. Indulás előtt ellenőrizzük a környezeteket, hitelesítő adatokat, hibakezelést és működési felelősségeket.
- **Hozzáférés és környezetek:** Erősítse meg a szerződésverziót, jóváhagyott munkaterületet, hitelesítési jogosultsági köröket, tesztkörnyezetet, éles hitelesítő adatokat és callbackcélokat.
- **Hibák és helyreállítás:** Kiadás előtt határozza meg az újrapróbálkozásokat, idempotenciát, időtúllépéseket, ügyfél számára látható hibákat, megfigyelhetőséget, támogatási felelősségeket és visszaállítást.
- **Teljes folyamat bizonyítéka:** Tesztelje az elképzelt felhasználói utat tesztkörnyezetben a belépéstől és állapotmódosítástól az ajánlaton, jóváhagyáson és átadáson át a helyreállításig.

## GYIK
- **Melyik termék-API-val kezdjem?:** Induljon a személyből és állapotátmenetből. Vásárlói klub- vagy közösségi utakhoz használjon közösségi beágyazást, jóváhagyott beszállítói folyamatokhoz beszállítói működést, SSO-hoz és SCIM-hez vállalati azonosítást, és csak kifejezetten engedélyezett AI-folyamatokhoz asszisztenseszközöket.
- **A nyilvános szerződés nyilvános éles hozzáférést jelent?:** Nem. A nyilvános OpenAPI-szerződés a felderítést, architektúra-ellenőrzést és kliensgenerálást támogatja. Az éles hitelesítő adatok, írási műveletek, beszállítói folyamatok, vállalati azonosítás és asszisztens-végrehajtás továbbra is jóváhagyott munkaterületet és körülhatárolt jogosultságot igényelhet.
- **Felfedhet beszállítókat vagy megkerülhet jóváhagyásokat az integráció?:** Nem. A beszállítói kilét és elérhetőségek bizalmasak maradnak az előírt közlések kivételével. A vásárlói kapcsolat a MerchandAise-é, a rendelést érintő műveleteknek pedig meg kell őrizniük a beállított digitális látványtervi, műszaki és rendelésspecifikus mintajóváhagyási követelményeket.

## Tervezze meg velünk integrációját.
Mondja el, ki használja az integrációt, milyen állapotot kell olvasnia vagy módosítania, és hol működik majd a felület. Önnel térképezzük fel a szerződést, hozzáférési modellt és a legbiztonságosabb bevezetési utat.
- **Integráció tervezése:** /hu/contact?intent=api-integration-review
- **AI-ügynökök és MCP felfedezése:** /hu/developers/ai-agents-mcp
