{"pageKey":"Developers","slug":"developers-api-integrations","locale":"de","localeResolved":"de","fallbackApplied":false,"version":"developers-api-integrations@2026-03-20T08:16:51.579Z","lastModified":"2026-03-20T08:16:51.579Z","canonicalUrl":"https://www.merchandaise.com/de/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"API-Verträge und Integrationsleitfäden für Custom-Merchandise | MerchandAise","description":"Nutze die MerchandAise API- und Integrationsseite für Assistant-Tooling-Dokumentation, Community-Einbettungen, Supplier-Workflows, Enterprise Identity und Produktionsfreigaben.","sections":[{"heading":"Was diese Seite abdeckt","paragraphs":["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."]},{"heading":"API- und Integrationsflächen","items":[{"title":"Assistant-Tooling-API-Dokumentation","description":"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."},{"title":"Community-Einbettungs-API","description":"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."},{"title":"Lieferanten-API","description":"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."},{"title":"Enterprise-Identity-API","description":"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."}]},{"heading":"Checkliste für die Produktionseinbindung","items":[{"title":"Step 1: Die passende Vertragsfläche wählen","description":"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."},{"title":"Step 2: Gegen versionierte Verträge testen","description":"Nutze die veröffentlichte OpenAPI-JSON für Client-Generierung, Contract Review, Staging-Validierung und Regressionstests, bevor Produktionsverkehr aktiviert wird."},{"title":"Step 3: Zugriff, Callbacks und Rollback dokumentieren","description":"Dokumentiere Authentifizierungs-Scopes, Callback-URLs, Umgebungsgrenzen, Observability und Rollback-Verantwortung vor dem Launch."}]},{"heading":"Produktionsschutz","items":[{"title":"Klare Vertragsverantwortung","description":"Jede Integrationsfläche verlinkt Implementierungsleitfaden und maschinenlesbaren Vertrag getrennt, damit Reviews und Umsetzung nicht vermischt werden."},{"title":"Locale-sichere Discovery","description":"Die Seite ist lokalisiert, in Locale-Sitemaps enthalten und aus der globalen Navigation erreichbar."},{"title":"Zugriffsgrenzen","description":"Öffentliche Verträge sind direkt verlinkt. Geschützte Enterprise- und assistant-autorisierte Verträge werden nicht als anonymer Zugriff dargestellt."}]},{"heading":"Bevor diese API-Integration live geht","paragraphs":["Nutze diese Prüfung, um öffentliche Verträge in einen unterstützten Integrationsplan mit klarer Zugriffskontrolle, Rollout-Planung und Rollback-Verantwortung zu überführen."],"items":[{"title":"Sandbox und Credentials prüfen lassen","description":"Leite deinen Use Case durch den Integrationsreview, damit öffentliche, Supplier- und geschützte Enterprise-Flächen korrekt eingegrenzt werden."},{"title":"Auth- und Callback-Grenzen dokumentieren","description":"Halte Scopes, Callback-URLs, Umgebungsnamen, Webhook-Verantwortung und kunden sichtbare Fehlerzustände fest."},{"title":"Contract Health vor Release prüfen","description":"Prüfe OpenAPI-JSON, geschütztes Zugriffsverhalten, Staging-Requests und Monitoring-Warnungen vor dem ersten Produktionshandoff."}]},{"heading":"FAQ","items":[{"title":"Mit welcher MerchandAise API soll ich starten?","description":"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."},{"title":"Sind die API-Verträge öffentlich?","description":"Assistant-Tooling-, Community- und Supplier-OpenAPI-Verträge sind öffentlich. Enterprise Identity und MCP-Tools-Listen sind geschützt und erfordern freigegebenen Zugriff."}]},{"heading":"Brauchst du einen Integrationsreview?","paragraphs":["Teile Workflow, Zielumgebung, Authentifizierungsbedarf und Launch-Timing. Das Integrationsteam empfiehlt die passende Vertragsfläche und den richtigen Rollout-Pfad."],"items":[{"title":"Mit dem Integrationsteam sprechen","description":"/de/contact?intent=api-integration-review"},{"title":"AI-Agents und MCP ansehen","description":"/de/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}