{"pageKey":"Developers","slug":"developers","locale":"de","localeResolved":"de","fallbackApplied":false,"version":"developers@2026-10-07T21:00:52.302Z","lastModified":null,"canonicalUrl":"https://www.merchandaise.com/de/developers","payload":{"slug":"developers","purpose":"llm-developers","title":"Developer Hub: Merchandise-APIs, OpenAPI & MCP | MerchandAise","description":"Integrieren Sie individuelle Merchandise-Produkte mit MerchandAise-APIs. Entdecken Sie OpenAPI-Dokumentation, Community-Einbettungen, Lieferantenprozesse, Enterprise-SSO und MCP-Tools.","sections":[{"heading":"MerchandAise Developer Hub","paragraphs":["Verbinden Sie Ihre Website, Geschäftssysteme oder Ihren KI-Assistenten mit MerchandAise. Entdecken Sie APIs für Produktdesign, Community-Storefronts, Lieferantenprozesse und Unternehmensidentität. OpenAPI-Spezifikationen und MCP-Dokumentation unterstützen die Integration."]},{"heading":"Für Teams, die Merchandise-Prozesse verbinden","items":[{"title":"Community-Betreiber","description":"Binden Sie Storefronts, Konfigurator-Übergaben und Community-Abläufe in Websites von Vereinen, Ligen und Unternehmen ein – mit versionierten öffentlichen Schnittstellen."},{"title":"Unternehmen und Plattformpartner","description":"Verbinden Sie Beschaffungsportale, Identitätssysteme und interne Abläufe mit Merchandise-Prozessen, ohne Freigaben und Lieferantenlogik neu aufzubauen."},{"title":"Entwickler von KI-Agenten und Automationen","description":"Geben Sie Assistenten über MCP-kompatible Endpunkte strukturierten Zugriff für Produktsuche, Angebote und freigegebene Abläufe."}]},{"heading":"Finden Sie Ihre Integration","items":[{"title":"API-Dokumentation & OpenAPI","description":"Finden Sie die API-Referenz für Assistenten-Tools und Design-Sessions. Wählen Sie anschließend den Community-, Lieferanten- oder Enterprise-Vertrag für Ihren Anwendungsfall. Implementierungsleitfaden: API-Dokumentation ansehen (/de/developers/api-integrations). Maschinenlesbarer Vertrag: OpenAPI-JSON für Assistenten-Tools (/api/docs/openapi.json). Zugriff: Öffentlich. Öffentliche Referenz für Assistenten- und Tooling-APIs. Produktivzugriff und Bestellvorgänge erfordern weiterhin die passende Autorisierung. Kanonischer Abschnitt: /de/developers#api-docs."},{"title":"Community API","description":"Verbinden Sie eine Vereins- oder Community-Website mit öffentlichen Community-Daten, Designeinreichungen, Abstimmungen und Übergaben zur Bestellfreigabe. Implementierungsleitfaden: Community API ansehen (/de/developers/api-integrations#community-integrations). Maschinenlesbarer Vertrag: Community OpenAPI JSON (/api/v1/community/public/openapi/v1). Zugriff: Öffentlich. Öffentlicher, versionierter Vertrag für Storefront-Einbettungen, Community-Suche und sprachspezifische Übergaben. Kanonischer Abschnitt: /de/developers#community-integrations."},{"title":"Lieferanten-API","description":"Verbinden Sie Systeme zugelassener Lieferanten mit freigegebenen Produktionspaketen, dem Onboarding-Status und ERP- oder PLM-Webhook-Prozessen. Implementierungsleitfaden: Lieferanten-API ansehen (/de/developers/api-integrations#supplier-integrations). Maschinenlesbarer Vertrag: Lieferanten-OpenAPI-JSON (/api/v1/supplier/openapi/v1). Zugriff: Öffentlich. Öffentlicher Vertrag für Planung und Client-Generierung. Operativer Lieferantenzugriff bleibt berechtigungsgebunden. Kanonischer Abschnitt: /de/developers#supplier-integrations."},{"title":"Enterprise Identity API","description":"Verbinden Sie zugelassene Unternehmens-Workspaces mit Single Sign-on, Benutzer- und Gruppenbereitstellung sowie Identity-Audit-Daten. Implementierungsleitfaden: Enterprise Identity ansehen (/de/developers/api-integrations#enterprise-integrations). Maschinenlesbarer Vertrag: Enterprise-Identity-OpenAPI-JSON (/api/v1/enterprise/identity/openapi/v1). Zugriff: Geschützt. Geschützter Vertrag für zugelassene Enterprise-Workspaces. Fordern Sie vor der Nutzung dieses Endpunkts Zugriff an. Kanonischer Abschnitt: /de/developers#enterprise-integrations."},{"title":"KI-Agenten & MCP","description":"Verbinden Sie einen KI-Assistenten über das Model Context Protocol. Entdecken Sie unterstützte Tools und bewahren Sie Designentscheidungen, Berechtigungen und erforderliche Bestätigungen der Nutzer. Implementierungsleitfaden: KI-Agenten & MCP ansehen (/de/developers/ai-agents-mcp). Maschinenlesbarer Vertrag: Öffentliche MCP-Serverkarten-JSON (/.well-known/mcp/server-card). Zugriff: Öffentlich. Öffentliches Dokument zur maschinellen Erkennung. Die externe Tool-Liste unter /api/v1/mcp/tools zeigt aktuelle Tool-Metadaten. Für jeden Aufruf gelten weiterhin die ausgewiesenen Sicherheits-, Workspace- und Bestätigungsregeln. Kanonischer Abschnitt: /de/developers#mcp-tools."}]},{"heading":"So starten Sie die Integration","items":[{"title":"Schritt 1: Wählen Sie den passenden Vertrag","description":"Beginnen Sie mit der Schnittstelle, die zu Ihren Nutzern und Ihrem Berechtigungsmodell passt: Community-Einbettung, Enterprise Identity, Lieferantenprozesse oder MCP-Tools für Assistenten."},{"title":"Schritt 2: Prüfen Sie Authentifizierung, Versionen und Umgebungen","description":"Bestätigen Sie erforderliche Header, Berechtigungsumfänge, Callback-Anforderungen und Vertragsversionen in einer Testumgebung, bevor Sie produktiven Datenverkehr weiterleiten."},{"title":"Schritt 3: Testen Sie den gesamten Ablauf vor dem Start","description":"Prüfen Sie Anfragen, Webhooks, Benutzerbereitstellung, Überwachung und Rückfallwege, damit die Integration vom ersten produktiven Einsatz an zuverlässig ist."}]},{"heading":"Was produktionsreif bedeutet","paragraphs":["Ein öffentlicher Endpunkt allein genügt nicht. Prüfen Sie diese Voraussetzungen, bevor Kunden-, Lieferanten-, Unternehmens- oder KI-Agenten-Prozesse produktiv genutzt werden."],"items":[{"title":"Testumgebung und Zugriffsprüfung","description":"Klären Sie, welche Verträge öffentlich sind, welche Enterprise-Schnittstellen eine Freigabe benötigen und welche Zugangsdaten oder Workspace-Rollen für den Start erforderlich sind."},{"title":"Nachweis der versionierten Implementierung","description":"Dokumentieren Sie generierte Clients, Callback-URLs, Berechtigungsumfänge, Vertragsversionen und die Verantwortung für Rückfallwege, bevor produktiver Datenverkehr aktiviert wird."},{"title":"Betriebliche Überwachung","description":"Planen Sie Logs, Wiederholungen, Support-Zuständigkeiten, Fehlerzustände und Zustandsprüfungen für jeden Ablauf, der Bestellungen, Lieferanten oder Unternehmensnutzer betreffen kann."}]},{"heading":"Vor der Implementierung","items":[{"title":"Welche MerchandAise-API soll ich verwenden?","description":"Die Community API unterstützt Vereins- und Community-Websites, die Lieferanten-API berechtigte Lieferantenprozesse und die Enterprise Identity API Unternehmensanmeldung und Benutzerbereitstellung. Die API-Referenz behandelt Assistenten-Tools; der MCP-Leitfaden erklärt, wie KI-Assistenten unterstützte Tools finden und nutzen."},{"title":"Kann ich die API-Spezifikationen ohne Konto lesen?","description":"Die OpenAPI-Spezifikationen für Assistenten-Tools, Community und Lieferanten sind öffentlich. Die Enterprise-Identity-Spezifikation ist geschützt. Eine öffentliche Spezifikation zu lesen, erlaubt weder geschützte Anfragen noch Bestellungen."},{"title":"Brauche ich eine Entwickler-Integration, um ein Produkt zu bestellen?","description":"Nein. Privatpersonen, Vereine und Unternehmen können auf der MerchandAise-Website unterstützte Produkte entdecken und ein Angebot anfragen. APIs sind eine optionale Möglichkeit, eigene Systeme oder Erlebnisse anzubinden."},{"title":"Was gehört in eine Integrationsanfrage?","description":"Beschreiben Sie die Nutzer, die beteiligten Systeme, die benötigten Lese- und Schreibzugriffe sowie Ihren Zeitplan. Nennen Sie bekannte Anforderungen an Anmeldung, Umgebung und Callbacks. Das Team prüft mit Ihnen den passenden Vertrag und das Zugriffsmodell."}]},{"heading":"Benötigen Sie eine Integrationsprüfung?","paragraphs":["Beschreiben Sie Ihre Architektur, Ihren Zeitplan und die geplanten Kanäle. Gemeinsam prüfen wir die passende Schnittstelle, das Berechtigungsmodell und die Reihenfolge für den Start."],"items":[{"title":"Integrationsteam kontaktieren","description":"/de/contact/integrations"},{"title":"Enterprise-Plattform ansehen","description":"/de/enterprise"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"route-owned-source","schema":"2025-11-05"}}