Für wen das gedacht ist
Die meisten Nutzer sollten einen KI-Agenten über den MCP-Server verbinden (siehe Wie Sie KI-Agenten über MCP mit 3Dsellers verbinden). Dieser Leitfaden richtet sich an Entwickler, die die 3Dsellers API direkt aus ihrem eigenen Code aufrufen oder Webhooks einrichten möchten. Der MCP-Server und die direkte API laufen auf derselben Plattform und nutzen dieselbe Authentifizierung.
Base URL und Versionierung
Alle API-Anfragen gehen an:
https://api.3dsellers.com
Ressourcen-Endpunkte sind unter /v1/ versioniert, zum Beispiel GET https://api.3dsellers.com/v1/products. Anfragen und Antworten sind JSON über HTTPS.
Authentifizierung
Es gibt zwei Möglichkeiten zur Authentifizierung, beide sind an Ihr 3Dsellers-Unternehmen gebunden:
Bearer Token - die schnellste Option für Ihre eigenen Skripte und Integrationen. Kopieren Sie ihn unter Settings > Integrations > MCP 3Dsellers (derselbe Token, der zum Verbinden eines KI-Agenten verwendet wird) und senden Sie ihn bei jeder Anfrage als
Authorization: Bearer YOUR_TOKEN-Header. Halten Sie ihn geheim und generieren Sie ihn über denselben Dialog neu, falls er jemals offengelegt wird.OAuth 2.0 (Authorization Code Flow) - für Apps, die im Namen anderer Verkäufer handeln. Leiten Sie den Nutzer über
GET /auth/authorize, tauschen Sie den zurückgegebenen Code unterPOST /auth/tokenein und verwenden Sie das erhaltene Access Token auf dieselbe Weise.GET /auth/mebestätigt, ob ein Token gültig ist.
Jede Anfrage ist auf das authentifizierte Unternehmen beschränkt. Um ein bestimmtes Marketplace-Konto anzusprechen, übergeben Sie dessen Seller ID (aus GET /v1/sellers).
Vollständige Endpunkt-Referenz
Die vollständige, stets aktuelle Liste der Endpunkte, Parameter und Antwortformate finden Sie in der interaktiven API-Dokumentation:
Betrachten Sie diese Seite als maßgebliche Quelle. Sie wird direkt aus der Live-API generiert und ist daher nie veraltet. Auf einen Blick deckt die API ab:
Products - Produkte auflisten, erstellen und aktualisieren, sowie Kategorien, Tags und SKU-Vorlagen
Listings - die kanalspezifische Ansicht Ihrer Produkte, mit Tags
Mapping templates - Feldzuordnungen zwischen Ihren Produkten und den einzelnen Kanälen, inklusive Bulk Apply
Orders - Bestellungen nach Verkäufer auflisten, mit Tags
Sellers and policies - verbundene Marketplace-Konten und deren Business Policies
Segments - Ihre gespeicherten Filtersets
CSV imports - Importjobs und ihre zeilenbezogenen Fehler
Bulk actions - große Batch-Vorgänge einreihen, einschließlich der Veröffentlichung von Produkten in einem Kanal, und deren Fortschritt abfragen
Webhooks
Um Echtzeit-Benachrichtigungen zu erhalten, statt zu pollen, registrieren Sie Ihren Endpunkt mit POST /webhooks/subscribe und entfernen Sie ihn mit POST /webhooks/unsubscribe. Die verfügbaren Events und Payloads finden Sie in der API-Dokumentation. Webhooks sind eine Funktion der direkten API und über den MCP-Server nicht verfügbar.
Direkte API vs. MCP-Server
Nutzen Sie den MCP-Server, wenn ein KI-Assistent (Claude, Cursor und ähnliche) Ihre Daten im Dialog lesen und darauf reagieren soll, ohne dass Code nötig ist. Nutzen Sie die direkte API, wenn Sie eigene Software schreiben, Webhooks benötigen oder eine feingranulare Kontrolle über jede Anfrage möchten. Beide verwenden dieselbe Base URL und denselben Token.
Zugriff und Rate Limits
API-Zugriff und Rate Limits hängen von Ihrem 3Dsellers-Abonnement ab. Wenn eine Anfrage aus Zugriffs- oder Ratengründen abgelehnt wird, prüfen Sie Ihren Plan oder verringern Sie Ihre Anfragerate. Für Details oder Fragen zu höheren Limits wenden Sie sich an das 3Dsellers-Team.
Brauchen Sie Hilfe?
Haben Sie Fragen zur API oder wünschen Sie sich einen Endpunkt, den es noch nicht gibt? Nutzen Sie die Schaltfläche "Need more MCP tools?" in Settings > Integrations > MCP 3Dsellers, oder wenden Sie sich an Ihren üblichen Support-Kanal.