# Merchandise API & integratiecontracten | MerchandAise

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

Ontdek MerchandAise-contracten voor assistent-tools, community-embeds, leveranciersprocessen en enterprise-identiteit, met duidelijke grenzen tussen openbare en beveiligde toegang.

## Houd één bron van waarheid
Een integratie moet de MerchandAise-workflow verlengen, niet splitsen. Website-, embed-, leverancier-, enterprise- en toekomstige assistent-interfaces moeten dezelfde versiegestuurde ontwerp-, commerce-intentie-, offerte-, goedkeurings- en orderstatus lezen en bijwerken.
Wanneer MerchandAise de aankooptransactie verwerkt, is Hutter Products GmbH de contracterende verkoper en Merchant of Record onder het MerchandAise‑merk. Leveranciersidentiteit en contactgegevens blijven privé, behalve waar openbaarmaking vereist is, en productie vereist nog steeds digitale goedkeuring en een goedkeuring van een echt productmonster.

## API en integratie-interfaces
- **Documentatie voor assistent-tooling-API:** Verken de huidige eindpunten voor assistenten en tooling voor ontwerpsessies en integratiebeoordelingen. Deze openbare referentie verleent geen anonieme bevoegdheid om offertes aan te vragen of bestellingen te plaatsen. Human guide: Open documentatie voor assistent-tooling (/nl/developers/api-integrations). Machine-readable contract: Assistent-tooling OpenAPI JSON (/api/docs/openapi.json). Access: public. Openbare referentie voor assistent- en tooling-APIs. Productietoegang en bewerkingen die van invloed zijn op bestellingen vereisen nog steeds de toepasselijke autorisatie. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs.
- **Gemeenschaps-embed API:** Verbind gelokaliseerde club-, gemeenschaps- of etalage-ervaringen met door MerchandAise beheerde ontwerp- en handelsoverdrachten zonder de onderliggende workflow opnieuw op te bouwen. Human guide: Bekijk de integratiehandleiding voor gemeenschappen (/nl/developers/api-integrations#community-integrations). Machine-readable contract: Gemeenschaps-OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. Openbaar contract met versiebeheer voor etalage-embeds, het ontdekken van gemeenschappen en regiobewuste overdrachten. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations.
- **Leveranciers-API:** Verbind goedgekeurde leveranciers met onboarding-, catalogus-, offerte- en afhandelingsprocessen nadat de leveranciersrelatie en het toegangsmodel zijn gekwalificeerd. Human guide: Bekijk de integratiehandleiding voor leveranciers (/nl/developers/api-integrations#supplier-integrations). Machine-readable contract: Leveranciers-OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. Openbaar contract voor planning en clientgeneratie. Operationele toegang voor leveranciers blijft onderhevig aan machtigingen. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations.
- **Ondernemingsidentiteit API:** Plan SSO, SCIM-provisioning en auditbestendige identiteitsstromen voor goedgekeurde merchandise-programma's van bedrijven en beheerde uitroltrajecten. Human guide: Bekijk de integratiehandleiding voor ondernemingen (/nl/developers/api-integrations#enterprise-integrations). Machine-readable contract: Ondernemingsidentiteit OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. Beveiligd contract voor goedgekeurde enterprise-werkruimten; vraag toegang aan alvorens dit eindpunt te gebruiken. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

## Kies het contract vóór de code
- **Step 1: Breng de gebruikersreis in kaart:** Bepaal wie de workflow binnenkomt en vanaf waar: een koper in een embedded storefront, een goedgekeurde leverancier, een enterprise‑gebruiker of een assistent die met expliciete autorisatie opereert.
- **Step 2: Bevestig de toegangsgrens:** Gebruik openbare contracten voor evaluatie en clientgeneratie, en bevestig daarna credentials, scopes, omgevingen, callbacks en beschermde endpoints vóór implementatie.
- **Step 3: Bewijs continuïteit van status:** Test of ontwerpen, offertes, goedkeuringen, fouten en order‑overdrachten versie‑actueel blijven over de integratie, inclusief retry‑ en rollback‑paden.

## Wat elke integratie moet waarborgen
- **Eén versiegestuurde status:** Ontwerp, commerce‑intentie, leverancier‑gedekte offerte, goedkeuring en orderstatus blijven verbonden. Verouderde wijzigingen moeten een zichtbare her‑offerte of review‑status triggeren.
- **Commerciële en leveranciersprivacy:** MerchandAise blijft de koper‑gerichte merchant en eigenaar van support. Leveranciersidentiteiten, contactgegevens en interne data worden niet blootgesteld via openbare integraties.
- **Goedkeuring vóór productie:** Een product‑native 3D‑weergave en digitale proof ondersteunen de beslissing, maar vervangen niet het vereiste echte productmonster vóór massaproductie.

## Vóór productie‑verkeer
Een gepubliceerde OpenAPI‑file is een planningsvlak, geen belofte van anonieme productie‑toegang. We beoordelen omgevingen, credentials, foutafhandeling en operationeel eigenaarschap vóór go‑live.
- **Toegang en omgevingen:** Bevestig de contractversie, goedgekeurde werkruimte, authenticatie‑scopes, sandbox, productie‑credentials en callback‑bestemmingen.
- **Fouten en herstel:** Definieer retries, idempotentie, timeouts, voor de klant zichtbare fouten, observability, support‑eigendomsverdeling en rollback vóór release.
- **End‑to‑end bewijs:** Verifieer de bedoelde reis in staging vanaf binnenkomst en statusmutatie tot offerte, goedkeuring, overdracht en herstelgedrag.

## FAQ
- **Met welk integratie‑oppervlak moet ik beginnen?:** Begin bij de persoon en de statusovergang. Gebruik community‑embeds voor kopergerichte club‑ of communityreizen, leveranciersoperaties voor goedgekeurde supply‑side workflows, enterprise‑identity voor SSO en SCIM, en assistent‑tooling alleen voor expliciet geautoriseerde AI‑gestuurde flows.
- **Betekent een openbaar contract publieke productie‑toegang?:** Nee. Een openbaar OpenAPI‑contract ondersteunt discovery, architectuurreview en clientgeneratie. Productie‑credentials, schrijfoperaties, leveranciersworkflows, enterprise‑identity en assistent‑uitvoering kunnen nog steeds een goedgekeurde werkruimte en gescopeerde autorisatie vereisen.
- **Kan een integratie leveranciers blootstellen of goedkeuringen omzeilen?:** Nee. Leveranciersidentiteit en contactgegevens blijven privé behalve waar openbaarmaking verplicht is. MerchandAise beheert de koperrelatie en order‑beïnvloedende acties moeten de geconfigureerde goedkeuringen en het gate voor echte productmonsters respecteren.

## Breng ons de workflow, niet een afgewerkte architectuur.
Vertel wie de integratie gebruikt, welke status ze moeten lezen of wijzigen en waar de ervaring plaatsvindt. Wij brengen het contract, het toegangsmodel en de veiligste uitrolroute in kaart met u.
- **Plan een integratie:** /nl/contact?intent=api-integration-review
- **Ontdek AI‑agents en MCP:** /nl/developers/ai-agents-mcp