# API-Verträge und Integrationsleitfäden für Custom-Merchandise | MerchandAise

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

Nutze die MerchandAise API- und Integrationsseite für Assistant-Tooling-Dokumentation, Community-Einbettungen, Supplier-Workflows, Enterprise Identity und Produktionsfreigaben.

## Was diese Seite abdeckt
Diese Seite ist der technische Einstieg für Teams, die MerchandAise als API-, SDK- oder Integrationsfläche bewerten. Sie trennt Implementierungsleitfäden von maschinenlesbaren Verträgen, damit Entwickler und AI-Assistenten die richtige Quelle zitieren.
Nutze sie für Assistant-Tooling-Dokumentation, Storefront-Einbettungen, Supplier-Operationen, Enterprise Identity und versionierte OpenAPI-Verträge vor der Implementierung.

## API- und Integrationsflächen
- **Assistant-Tooling-API-Dokumentation:** Lies die OpenAPI-Dokumentation für Design Sessions, Tool-Nutzung und Integrationsreviews. Community-, Supplier- und Enterprise-Verträge sind separat ausgewiesen. Human guide: Assistant-Tooling-Dokumentation öffnen (/api/docs). Machine-readable contract: Assistant-Tooling-OpenAPI-JSON (/api/docs/openapi.json). Access: public. Öffentliche maschinenlesbare OpenAPI für Assistant- und Tooling-APIs; für Community-, Supplier- und Enterprise-Implementierungen gelten die jeweiligen Domain-Verträge. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs.
- **Community-Einbettungs-API:** Implementiere locale-sichere Storefront-Einbettungen, Community-Workflows und authentifizierte Übergaben mit einem versionierten öffentlichen Vertrag. Human guide: Community-Implementierung prüfen (/de/developers/api-integrations#community-integrations). Machine-readable contract: Offener Gemeinschaftsvertrag (/api/v1/community/public/openapi/v1). Access: public. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations.
- **Lieferanten-API:** Verbinde Onboarding, Katalogdaten und lieferantenseitige Operationen über versionierte Endpunkte für Fulfillment-Workflows. Human guide: Lieferanten-Integration prüfen (/de/developers/api-integrations#supplier-integrations). Machine-readable contract: Offener Lieferantenvertrag (/api/v1/supplier/openapi/v1). Access: public. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations.
- **Enterprise-Identity-API:** Integriere SSO, SCIM-Provisioning und revisionssichere Identity-Flows für Enterprise-Rollouts über geschützte Verträge. Human guide: Enterprise-Integration prüfen (/de/developers/api-integrations#enterprise-integrations). Machine-readable contract: Öffnen Sie den Enterprise-Identity-Vertrag (/api/v1/enterprise/identity/openapi/v1). Access: protected. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

## Checkliste für die Produktionseinbindung
- **Step 1: Die passende Vertragsfläche wählen:** Ordne die Integration zuerst der User Journey zu: Community-Einbettungen für öffentliche Storefronts, Supplier-APIs für Fulfillment-Workflows und Enterprise Identity für SSO, SCIM und geregelte Rollouts.
- **Step 2: Gegen versionierte Verträge testen:** Nutze die veröffentlichte OpenAPI-JSON für Client-Generierung, Contract Review, Staging-Validierung und Regressionstests, bevor Produktionsverkehr aktiviert wird.
- **Step 3: Zugriff, Callbacks und Rollback dokumentieren:** Dokumentiere Authentifizierungs-Scopes, Callback-URLs, Umgebungsgrenzen, Observability und Rollback-Verantwortung vor dem Launch.

## Produktionsschutz
- **Klare Vertragsverantwortung:** Jede Integrationsfläche verlinkt Implementierungsleitfaden und maschinenlesbaren Vertrag getrennt, damit Reviews und Umsetzung nicht vermischt werden.
- **Locale-sichere Discovery:** Die Seite ist lokalisiert, in Locale-Sitemaps enthalten und aus der globalen Navigation erreichbar.
- **Zugriffsgrenzen:** Öffentliche Verträge sind direkt verlinkt. Geschützte Enterprise- und assistant-autorisierte Verträge werden nicht als anonymer Zugriff dargestellt.

## Bevor diese API-Integration live geht
Nutze diese Prüfung, um öffentliche Verträge in einen unterstützten Integrationsplan mit klarer Zugriffskontrolle, Rollout-Planung und Rollback-Verantwortung zu überführen.
- **Sandbox und Credentials prüfen lassen:** Leite deinen Use Case durch den Integrationsreview, damit öffentliche, Supplier- und geschützte Enterprise-Flächen korrekt eingegrenzt werden.
- **Auth- und Callback-Grenzen dokumentieren:** Halte Scopes, Callback-URLs, Umgebungsnamen, Webhook-Verantwortung und kunden sichtbare Fehlerzustände fest.
- **Contract Health vor Release prüfen:** Prüfe OpenAPI-JSON, geschütztes Zugriffsverhalten, Staging-Requests und Monitoring-Warnungen vor dem ersten Produktionshandoff.

## FAQ
- **Mit welcher MerchandAise API soll ich starten?:** Starte mit der Fläche, die zur User Journey passt: Community-Einbettungen für Storefront-Erlebnisse, Supplier-APIs für Fulfillment-Workflows und Enterprise Identity für SSO- oder SCIM-Rollouts.
- **Sind die API-Verträge öffentlich?:** Assistant-Tooling-, Community- und Supplier-OpenAPI-Verträge sind öffentlich. Enterprise Identity und MCP-Tools-Listen sind geschützt und erfordern freigegebenen Zugriff.

## Brauchst du einen Integrationsreview?
Teile Workflow, Zielumgebung, Authentifizierungsbedarf und Launch-Timing. Das Integrationsteam empfiehlt die passende Vertragsfläche und den richtigen Rollout-Pfad.
- **Mit dem Integrationsteam sprechen:** /de/contact?intent=api-integration-review
- **AI-Agents und MCP ansehen:** /de/developers/ai-agents-mcp