{"pageKey":"Developers","slug":"developers-api-integrations","locale":"hu","localeResolved":"hu","fallbackApplied":false,"version":"developers-api-integrations@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/hu/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"Merchandise API és integrációs szerződések | MerchandAise","description":"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.","sections":[{"heading":"Őrizze meg az egyetlen hiteles forrást","paragraphs":["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."]},{"heading":"API és integrációs felületek","items":[{"title":"Asszisztens-eszközök API dokumentáció","description":"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."},{"title":"Közösségi beágyazás API","description":"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."},{"title":"Beszállítói API","description":"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."},{"title":"Vállalati azonosítás API","description":"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."}]},{"heading":"Válassza ki a szerződést a kód megírása előtt","items":[{"title":"Step 1: Térképezze fel a felhasználói utat","description":"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."},{"title":"Step 2: Ellenőrizze a hozzáférési határokat","description":"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."},{"title":"Step 3: Biztosítsa az állapot folytonosságát","description":"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."}]},{"heading":"Amit minden integrációnak meg kell őriznie","items":[{"title":"Egyetlen verziózott állapot","description":"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."},{"title":"Kereskedelmi és beszállítói adatvédelem","description":"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."},{"title":"Gyártás előtti jóváhagyás","description":"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."}]},{"heading":"Az éles forgalom elindítása előtt","paragraphs":["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."],"items":[{"title":"Hozzáférés és környezetek","description":"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."},{"title":"Hibakezelés és helyreállítás","description":"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)."},{"title":"Végpontok közötti igazolás","description":"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."}]},{"heading":"GYIK","items":[{"title":"Melyik integrációs felülettel érdemes kezdenem?","description":"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."},{"title":"A nyilvános szerződés nyilvános éles hozzáférést is jelent?","description":"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."},{"title":"Kiszivárogtathatja-e az integráció a beszállítókat, vagy megkerülheti-e a jóváhagyásokat?","description":"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."}]},{"heading":"A munkafolyamatot mutassa be nekünk, ne a kész architektúrát.","paragraphs":["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."],"items":[{"title":"Integráció tervezése","description":"/hu/contact?intent=api-integration-review"},{"title":"AI-ágensek és MCP felfedezése","description":"/hu/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}