# Merchandise API és integrációs szerződések | MerchandAise

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

Fedezze fel a MerchandAise asszisztens-eszközökhöz, közösségi beágyazásokhoz, beszállítói folyamatokhoz és vállalati azonosításhoz készült szerződéseit, egyértelmű nyilvános és védett hozzáférési határokkal.

## Őrizze meg az egyetlen hiteles forrást
Az integrációnak ki kell terjesztenie a MerchandAise munkafolyamatot, nem pedig elágaztatnia azt. A weboldalaknak, beágyazásoknak, beszállítói, vállalati és jövőbeli asszisztens-felületeknek ugyanazt a verziózott tervezési, kereskedelmi szándék-, árajánlati, jóváhagyási és rendelési állapotot kell olvasniuk és frissíteniük.
Ahol a MerchandAise dolgozza fel a vevői tranzakciót, ott a Hutter Products GmbH a szerződéses eladó és a bejegyzett kereskedő (Merchant of Record) a MerchandAise márkanév alatt. A beszállítói identitás és a kapcsolattartási adatok magánjellegűek maradnak, kivéve ha a közzététel kötelező, és a gyártáshoz továbbra is szükség van a digitális látványterv és a valódi gyártási minta jóváhagyására.

## API és integrációs felületek
- **Asszisztens-eszközök API dokumentáció:** Fedezze fel a tervezési munkamenetekhez és az integráció felülvizsgálatához használható aktuális asszisztens- és eszköz-végpontokat. Ez a nyilvános hivatkozás nem biztosít névtelen jogosultságot árajánlatkérésre vagy rendelés leadására. Human guide: Asszisztens-eszközök dokumentációjának megnyitása (/hu/developers/api-integrations). Machine-readable contract: Asszisztens-eszközök OpenAPI JSON (/api/docs/openapi.json). Access: public. Nyilvános hivatkozás az asszisztens- és eszköz-API-khoz. Az éles hozzáféréshez és a rendelést érintő műveletekhez továbbra is a megfelelő felhatalmazás szükséges. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs.
- **Közösségi beágyazás API:** Csatlakoztasson lokalizált klub-, közösségi vagy áruházi élményeket a MerchandAise tulajdonában lévő tervezési és kereskedelmi átadási pontokhoz anélkül, hogy újra kellene építenie a mögöttes munkafolyamatot. Human guide: Közösségi integrációs útmutató áttekintése (/hu/developers/api-integrations#community-integrations). Machine-readable contract: Közösségi OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. Nyilvános, verziózott szerződés áruházi beágyazásokhoz, közösségi felfedezéshez és lokalizáció-érzékeny átadásokhoz. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations.
- **Beszállítói API:** Csatlakozza a jóváhagyott beszállítókat a regisztrációs, katalógus-, árajánlat- és teljesítési folyamatokhoz, miután a beszállítói kapcsolat és a hozzáférési modell minősítése megtörtént. Human guide: Beszállítói integrációs útmutató áttekintése (/hu/developers/api-integrations#supplier-integrations). Machine-readable contract: Beszállítói OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. Nyilvános szerződés tervezéshez és kliensgeneráláshoz. Az operatív beszállítói hozzáférés továbbra is engedélyhez kötött. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations.
- **Vállalati azonosítás API:** Tervezzen SSO-t, SCIM-kiépítést és auditálható azonosítási folyamatokat a jóváhagyott vállalati merchandise-programokhoz és a szabályozott bevezetésekhez. Human guide: Vállalati integrációs útmutató áttekintése (/hu/developers/api-integrations#enterprise-integrations). Machine-readable contract: Vállalati azonosítás OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. Védett szerződés jóváhagyott vállalati munkaterületekhez; a végpont használata előtt kérjen hozzáférést. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

## Válassza ki a szerződést a kód megírása előtt
- **Step 1: Térképezze fel a felhasználói utat:** Döntse el, ki és hol lép be a munkafolyamatba: egy vevő egy beágyazott áruházban, egy jóváhagyott beszállító, egy vállalati felhasználó vagy egy kifejezett felhatalmazással működő asszisztens.
- **Step 2: Ellenőrizze a hozzáférési határokat:** Használja a nyilvános szerződéseket az értékeléshez és a kliensgeneráláshoz, majd az implementáció előtt ellenőrizze a hitelesítő adatokat, a hatóköröket (scopes), a környezeteket, a visszahívásokat (callbacks) és a védett végpontokat.
- **Step 3: Biztosítsa az állapot folytonosságát:** Tesztelje, hogy a tervek, árajánlatok, jóváhagyások, hibák és rendelésátadások verziója naprakész marad-e az integráció során, beleértve az újrapróbálkozási és a visszagörgetési (rollback) útvonalakat is.

## Amit minden integrációnak meg kell őriznie
- **Egyetlen verziózott állapot:** A tervezés, a kereskedelmi szándék, a beszállítói hátterű árajánlat, a jóváhagyás és a rendelési állapot összekapcsolva maradnak. Az elavult módosításoknak látható újbóli árajánlatkérést vagy felülvizsgálati állapotot kell kiváltaniuk.
- **Kereskedelmi és beszállítói adatvédelem:** A MerchandAise marad a vevő felé néző kereskedő és az ügyfélszolgálat tulajdonosa. A beszállítói identitások, kapcsolatok és belső adatok nem kerülnek nyilvánosságra a nyilvános integrációkon keresztül.
- **Gyártás előtti jóváhagyás:** A termék saját 3D nézete és a digitális látványterv támogatja a döntést, de nem helyettesíti a tömeggyártás előtt kötelezően előírt valódi gyártási mintát.

## Az éles forgalom elindítása előtt
A közzétett OpenAPI fájl egy tervezési felület, nem pedig az éles környezethez való névtelen hozzáférés ígérete. Az élesítés előtt áttekintjük a környezeteket, a hitelesítő adatokat, a hibakezelést és az üzemeltetési felelősséget.
- **Hozzáférés és környezetek:** Ellenőrizze a szerződés verzióját, a jóváhagyott munkaterületet, a hitelesítési hatóköröket (scopes), a sandboxot, az éles hitelesítő adatokat és a visszahívási célhelyeket.
- **Hibakezelés és helyreállítás:** A kiadás előtt határozza meg az újrapróbálkozásokat, az idempotenciát, az időtúllépéseket, az ügyfelek számára látható hibákat, a megfigyelhetőséget (observability), az ügyfélszolgálati felelősséget és a visszagörgetést (rollback).
- **Végpontok közötti igazolás:** Ellenőrizze a tervezett utat a staging környezetben a belépéstől és az állapotváltozástól kezdve az árajánlaton, jóváhagyáson és átadáson át egészen a helyreállítási folyamatokig.

## GYIK
- **Melyik integrációs felülettel érdemes kezdenem?:** Kezdje a felhasználóval és az állapotátmenettel. Használjon közösségi beágyazásokat a vevőoldali klub- vagy közösségi utakhoz, beszállítói folyamatokat a jóváhagyott kínálati oldali munkafolyamatokhoz, vállalati azonosítást az SSO és SCIM folyamatokhoz, és asszisztens-eszközöket kizárólag a kifejezetten engedélyezett, AI által vezérelt folyamatokhoz.
- **A nyilvános szerződés nyilvános éles hozzáférést is jelent?:** Nem. A nyilvános OpenAPI szerződés a felfedezést, az architektúra felülvizsgálatát és a kliensgenerálást támogatja. Az éles hitelesítő adatok, az írási műveletek, a beszállítói munkafolyamatok, a vállalati azonosítás és az asszisztens-futtatás továbbra is jóváhagyott munkaterületet és meghatározott hatókörű felhatalmazást igényelhetnek.
- **Kiszivárogtathatja-e az integráció a beszállítókat, vagy megkerülheti-e a jóváhagyásokat?:** Nem. A beszállítói identitás és a kapcsolattartási adatok magánjellegűek maradnak, kivéve ha a közzététel kötelező; a vevői kapcsolat a MerchandAise tulajdonában van, és a rendelést érintő műveleteknek meg kell őrizniük a beállított jóváhagyási és valódi gyártási minta ellenőrzési pontokat.

## A munkafolyamatot mutassa be nekünk, ne a kész architektúrát.
Mondja el, ki fogja használni az integrációt, melyik állapotot kell olvasnia vagy módosítania, és hol fog működni a felhasználói élmény. Közösen feltérképezzük a szerződést, a hozzáférési modellt és a legbiztonságosabb bevezetési útvonalat.
- **Integráció tervezése:** /hu/contact?intent=api-integration-review
- **AI-ágensek és MCP felfedezése:** /hu/developers/ai-agents-mcp