{"pageKey":"Developers","slug":"developers-api-integrations","locale":"nl","localeResolved":"nl","fallbackApplied":false,"version":"developers-api-integrations@2026-11-21T00:04:58.756Z","lastModified":null,"canonicalUrl":"https://www.merchandaise.com/nl/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"Merchandise-API’s: documentatie en OpenAPI-integraties | MerchandAise","description":"Ontdek MerchandAise API-documentatie en OpenAPI-specificaties voor aangepaste merchandise, community-embeds, leveranciersworkflows en bedrijfsidentiteit.","sections":[{"heading":"Kies de verbinding die je project nodig heeft","paragraphs":["Gebruik de onderstaande documentatie om eindpunten, aanvraagformaten en autorisatievereisten te beoordelen. Openbare specificaties ondersteunen planning en het genereren van clients. Operationele toegang hangt af van de API, het account en de omgeving.","Waar MerchandAise de klanttransactie verwerkt, is Hutter Products GmbH onder het merk MerchandAise de contractuele verkoper en Merchant of Record. Leveranciersidentiteiten en contactgegevens blijven privé, behalve waar openbaarmaking vereist is. Productie vereist nog steeds goedkeuring van de digitale proef, bevestigde maakbaarheid, verplichte technische controles en de monstergoedkeuringen die voor de exact aanvaarde bestelling gelden."]},{"heading":"API en integratiefuncties","items":[{"title":"API-documentatie en OpenAPI","description":"Zoek de API-referentie voor assistent-tooling en ontwerpsessies en kies vervolgens het community-, leveranciers- of ondernemingscontract voor je workflow. Human guide: Lees assistent-toolingdocumentatie (/api/docs). Machine-readable contract: Assistent-tooling OpenAPI JSON (/api/docs/openapi.json). Toegang: Openbaar. Openbare referentie voor assistent- en tooling API’s. Voor productietoegang en orderbeïnvloedende handelingen is nog steeds de toepasselijke autorisatie vereist. Canonical page: /nl/developers/api-integrations. Canonical section: /nl/developers/api-integrations#api-docs."},{"title":"Community API","description":"Verbind een club- of communitywebsite met openbare community-informatie, ontwerpinzendingen, stemmingen en overdrachten van goedkeuringen van bestellingen. Wat het contract omvat: Openbare communitycontext, ontwerpposts en -stemmen, publicatielijsten, lopende bestellingen en goedkeuring of afwijzing door community-eigenaren. Een praktisch uitgangspunt: Lees de openbare communitycontext voor een clubwebsite. Breng vervolgens in kaart welke acties een ledensessie of eigenaarsrechten vereisen voordat ontwerpinzendingen of betalingsoverdrachten worden toegevoegd. Toegang: De specificatie is openbaar. Openbare leesacties, ledenacties en acties voor eigenaren hebben verschillende autorisatievereisten. Volg de beveiligingsregels van elk eindpunt. Human guide: Ontdek de community API (/nl/developers/api-integrations#community-integrations). Machine-readable contract: Community OpenAPI JSON (/api/v1/community/public/openapi/v1). Toegang: Openbaar. Openbaar, geversioneerd API-contract voor winkel-embeds, communityontdekking en overdrachten met behoud van de taalinstelling. Canonical page: /nl/developers/api-integrations. Canonical section: /nl/developers/api-integrations#community-integrations."},{"title":"Leveranciers-API","description":"Verbind goedgekeurde leverancierssystemen met vrijgegeven productiepakketten, onboardingstatus en ERP- of PLM-webhookworkflows. Wat het contract omvat: Onboardingstatus van leveranciers, vrijgegeven productiepakketten, gecontroleerde downloads van bestanden, analyses, webhookabonnementen en controlepunten voor synchronisatie. Een praktisch uitgangspunt: Plan een verbinding tussen je ERP- of PLM-systeem en het Supplier Center. Controleer webhook-payloads, herhaalde verzoeken en de synchronisatiestatus voordat je een toegewezen bestelling verwerkt. Toegang: Lees de OpenAPI-specificatie zonder in te loggen. Operationele verzoeken vereisen het juiste leveranciersaccount en de juiste rechten. Openbare documentatie schrijft geen leverancier in en geeft geen toegang tot gegevens van andere leveranciers. Human guide: Ontdek de leveranciers-API (/nl/developers/api-integrations#supplier-integrations). Machine-readable contract: Leveranciers-OpenAPI JSON (/api/v1/supplier/openapi/v1). Toegang: Openbaar. Openbaar API-contract voor planning en het genereren van clients. Operationele toegang voor leveranciers vereist nog steeds autorisatie. Canonical page: /nl/developers/api-integrations. Canonical section: /nl/developers/api-integrations#supplier-integrations."},{"title":"Enterprise Identity API","description":"Koppel goedgekeurde bedrijfswerkruimtes aan single sign-on, gebruikers- en groepsbeheer en auditgegevens over identiteit. Wat het contract omvat: OpenID Connect (OIDC) voor single sign-on, SCIM-acties voor de levenscyclus van gebruikers en groepen, SCIM-tokenrotatie en auditgebeurtenissen voor provisioning. Een praktisch uitgangspunt: Koppel je identiteitsprovider aan de goedgekeurde werkruimte. Plan aanmelding en het aanmaken en verwijderen van gebruikers. Controleer vervolgens groepskoppelingen en auditgegevens in de afgesproken testomgeving. Toegang: De Enterprise Identity-specificatie is beveiligd. Neem vóór implementatie contact op met het integratieteam om werkruimte- en toegangsvereisten te bespreken. Enterprise Identity is optioneel voor gewone productaankopen. Human guide: Bekijk de Enterprise Identity API (/nl/developers/api-integrations#enterprise-integrations). Machine-readable contract: Enterprise Identity OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Toegang: Beschermd. Beschermd contract voor goedgekeurde bedrijfswerkruimtes; vraag toegang aan voordat je dit eindpunt gebruikt. Canonical page: /nl/developers/api-integrations. Canonical section: /nl/developers/api-integrations#enterprise-integrations."}]},{"heading":"Kies het contract vóór de code","items":[{"title":"Step 1: Breng de gebruikersreis in kaart","description":"Bepaal wie de workflow betreedt en waar: een koper in een geïntegreerde winkel, een goedgekeurde leverancier, een zakelijke gebruiker of een assistent die werkt met expliciete toestemming."},{"title":"Step 2: Bevestig de toegangsgrens","description":"Gebruik openbare contracten voor evaluatie en het genereren van clients, en bevestig vervolgens inloggegevens, scopes, omgevingen, callbacks en beschermde eindpunten vóór implementatie."},{"title":"Step 3: Controleer de continuïteit van de status","description":"Test of ontwerpen, offertes, goedkeuringen, fouten en besteloverdrachten tijdens de hele integratie aan de actuele versie gekoppeld blijven, inclusief herhaalde verzoeken en herstel bij terugdraaien."}]},{"heading":"Wat elke integratie moet behouden","items":[{"title":"Eén status met versiebeheer","description":"Ontwerp, koopintentie, door leveranciers onderbouwde offerte, goedkeuring en bestelstatus blijven verbonden. Verouderde wijzigingen moeten zichtbaar een nieuwe offerte of beoordeling vereisen."},{"title":"Commerciële en leveranciersprivacy","description":"MerchandAise blijft de kopergerichte verkoper en ondersteuningseigenaar. Leveranciersidentiteiten, contacten en interne gegevens worden niet openbaar gemaakt via publieke integraties."},{"title":"Goedkeuring vóór productie","description":"Een 3D-preview is geen fysiek monster. De bevestigde offerte beschrijft beschikbare klantmonsteropties, kosten, beperkingen en planning. Keur de exacte digitale proef goed en voltooi vóór serieproductie de verplichte technische controles en vereiste of gekozen monstergoedkeuringen. Bestaande vereisten voor aanvaarde bestellingen blijven bindend."}]},{"heading":"Vóór productieverkeer","paragraphs":["Een gepubliceerd OpenAPI-bestand helpt je plannen en belooft geen anonieme toegang tot productie. We beoordelen omgevingen, inloggegevens, foutafhandeling en operationele verantwoordelijkheid voordat de integratie live gaat."],"items":[{"title":"Toegang en omgevingen","description":"Bevestig de contractversie, goedgekeurde werkruimte, authenticatiescopes, testomgeving, productie-inloggegevens en callbackbestemmingen."},{"title":"Fouten en herstel","description":"Leg vóór release herhaalde verzoeken, idempotentie, time-outs, zichtbare fouten, monitoring, verantwoordelijkheid voor ondersteuning en terugdraaien vast."},{"title":"End-to-end bewijs","description":"Controleer de beoogde gebruikersreis in de testomgeving: van binnenkomst en statuswijziging tot offerte, goedkeuring, overdracht en herstel."}]},{"heading":"Veelgestelde vragen","items":[{"title":"Met welke merchandise API moet ik beginnen?","description":"Begin met wie de integratie gebruikt en welke status verandert. Gebruik community-embeds voor klantgerichte club- en communityworkflows, leveranciersactiviteiten voor goedgekeurde leveranciersworkflows, bedrijfsidentiteit voor SSO en SCIM, en assistenttools alleen voor expliciet geautoriseerde AI-workflows."},{"title":"Betekent een openbaar API-contract ook openbare toegang tot productie?","description":"Nee. Een openbaar OpenAPI-contract ondersteunt ontdekking, architectuurbeoordeling en het genereren van clients. Productie-inloggegevens, schrijfacties, leveranciersworkflows, bedrijfsidentiteit en acties van assistenten kunnen nog steeds een goedgekeurde werkruimte en afgebakende autorisatie vereisen."},{"title":"Kan een integratie leveranciers blootleggen of goedkeuringen omzeilen?","description":"Nee. Leveranciersidentiteiten en contactgegevens blijven privé, behalve waar openbaarmaking vereist is. MerchandAise blijft verantwoordelijk voor de klantrelatie. Acties die bestellingen beïnvloeden moeten de ingestelde vereisten voor digitale proef, technische controles en bestellingsspecifieke monstergoedkeuring behouden."}]},{"heading":"Plan je integratie met ons.","paragraphs":["Vertel ons wie de integratie gaat gebruiken, welke status ze moeten lezen of wijzigen, en waar de ervaring zal plaatsvinden. Samen met je brengen wij het contract, het toegangsmodel en het veiligste uitroltraject in kaart."],"items":[{"title":"Plan een integratie","description":"/nl/contact?intent=api-integration-review"},{"title":"Ontdek AI-agenten en MCP","description":"/nl/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"route-owned-source","schema":"2025-11-05"}}