Übersicht
Die 3Dsellers API ermöglicht es eBay-Verkäufern und Entwicklern, ihre Online-Shops nahtlos mit der 3Dsellers-Plattform zu verbinden. Diese RESTful API erlaubt es Ihnen, Aufgaben zu automatisieren, Angebote programmgesteuert zu verwalten, Daten über mehrere Plattformen hinweg zu synchronisieren und eigene Integrationen zu erstellen, die Ihre eCommerce-Prozesse optimieren. Egal, ob Sie als technisch versierter Verkäufer Workflows automatisieren möchten oder als Entwickler eigene Lösungen entwickeln - die 3Dsellers API bietet Ihnen die Werkzeuge, um Ihre Verkaufsmöglichkeiten zu erweitern und zu verbessern.
Hinweis: Um auf die 3Dsellers API zuzugreifen und sie zu nutzen, benötigen Sie Administratorrechte in Ihrem 3Dsellers-Konto.
So aktivieren Sie die 3Dsellers API
Melden Sie sich bei Ihrem 3Dsellers-Konto an
Gehen Sie im Hauptmenü zu Settings
Klicken Sie im Einstellungsmenü auf Integrations
Suchen Sie den Bereich 3Dsellers API
Klicken Sie auf Generate API Key, um einen neuen API-Schlüssel zu erstellen
Kopieren Sie den generierten API-Schlüssel und bewahren Sie ihn sicher auf - Sie benötigen ihn für die Authentifizierung
API-Authentifizierung
Auth2 ist nicht erforderlich, wenn Sie Ihr API-Token in der 3Dsellers-App generiert haben. Senden Sie in diesem Fall bei jeder Anfrage einfach den Header Authorization: Bearer <your_token> mit.
Der OAuth2-Flow dient dem Aufbau einer Anwendung, die andere Verkäufer autorisieren. In diesem Fall:
Leiten Sie den Verkäufer zu
GET /auth/authorizeweiterTauschen Sie das Ergebnis unter
POST /auth/tokengegen ein Token einSenden Sie das Zugriffstoken bei jeder Anfrage als
Authorization: Bearer YOUR_ACCESS_TOKENPrüfen Sie mit
GET /auth/me, ob ein Token noch gültig ist
Vollständige Details zum Ablauf finden Sie in der API-Dokumentation.
Was die API abdeckt
Die Referenz unter api.3dsellers.com/docs ist die vollständige, stets aktuelle Liste. Hier sehen Sie den groben Aufbau, damit Sie wissen, wo Sie nachsehen müssen:
Produkte und Katalog
Produkte lesen, erstellen, aktualisieren und patchen. Kategorien, benutzerdefinierte Attribute und SKU-Vorlagen verwalten. Angebote lesen und taggen. Produkte auf einem Marktplatz veröffentlichen. Katalogkategorien auf Kanalkategorien abbilden und Produktdaten auf Artikelmerkmale des Kanals abbilden.
Bestellungen
Bestellungen eines Verkäuferkontos lesen, Versanddienstleister und Sendungsnummern an den Marktplatz zurückmelden und Bestellungen in großen Mengen taggen.
Helpdesk
Tickets und Anzahl pro Status auflisten, vollständige Nachrichtenverläufe inklusive Käufer-Anhängen lesen, Käufern antworten und Ticketstatus oder -typ festlegen.
Verkäufer und Integrationen
Verbundene Marktplatzkonten auflisten, den Integrationsstatus prüfen, die Bestandssynchronisierung des Katalogs ein-/ausschalten, eBay-Geschäftsrichtlinien lesen und eBay Store-Kategorien verwalten.
Bulk actions
Stellen Sie dieselben Batch-Operationen in eine Warteschlange, die die App aus einer Rasterauswahl ausführt, und fragen Sie deren Fortschritt ab. Sie laufen asynchron.
Feste Regeln
Automations (ein Trigger plus Aktionen für Angebote, Katalog, Bestellungen und Helpdesk), Angebotsregeln für eBay-Preisvorschläge sowie Auto Messages nach dem Verkauf.
Daten-Import und -Export
Exporte und wiederkehrende Exportzeitpläne einplanen, CSV-Importe und ihre zeilenbezogenen Fehler überwachen sowie Filtersets als Segmente speichern oder wiederverwenden.
Listing Designer
HTML-Designs erstellen und bearbeiten, die eBay-Artikelbeschreibungen umschließen, und festlegen, welche Vorlage neue Angebote erhalten.
Webhooks
POST /webhooks/subscribe und POST /webhooks/unsubscribe. Unterstützte Events:
order.createdimport-csv.status-updated
Health Check
GET /health/live- der Dienst ist aktivGET /health/ready- der Dienst ist bereit für Anfragen
Rate Limits
Die API erzwingt Rate Limits, um die Performance für alle Konten fair zu halten. Bauen Sie Ihre Integration so, dass sie damit umgehen kann:
Behandeln Sie Rate-Limit-Antworten explizit, anstatt sie stillschweigend fehlschlagen zu lassen
Warten Sie exponentiell länger und versuchen Sie es erneut
Bevorzugen Sie Webhooks gegenüber Polling und Batch-Endpunkte gegenüber Einzelaufrufen pro Datensatz
Kontaktieren Sie den Support, wenn Ihr Anwendungsfall wirklich ein höheres Limit benötigt
Fehlerbehebung
Ich erhalte den Fehler "Invalid API Token"
Prüfen Sie, ob Sie das gesamte Token von der Integrations-Seite kopiert haben
Generieren Sie ein neues Token und aktualisieren Sie es in Ihrer Integration
Stellen Sie sicher, dass der Header exakt
Authorization: Bearer <your_token>lautet
Ich erhalte den Fehler "Insufficient scope"
Das Token ist gültig, aber nicht für diesen Bereich autorisiert. Generieren Sie es neu oder autorisieren Sie es erneut, sodass es die von Ihnen aufgerufenen Endpunkte abdeckt.
Kann ich Varianten und Bestand über die API verwalten?
Ja. Produkte unterstützen Varianten, und der Bestand kann gelesen und geschrieben werden, einschließlich lagerspezifischer Bestände. Siehe die Produkt-Endpunkte in der Referenz.
Warum liefert mein Aufruf eine Antwort, bevor sich etwas geändert hat?
Bulk Actions, Exporte und einige umfangreiche Mapping-Vorgänge sind bewusst asynchron. Der Aufruf liefert eine ID zurück, und Sie fragen mit dieser ID den Fortschritt ab. Eine Antwort ist nicht dasselbe wie ein abgeschlossener Job.
Gibt es Einschränkungen?
Manche Endpunkte erfordern eine bestimmte Plan-Funktion, und manche Aktionen sind auf bestimmte Kanäle beschränkt. Die Referenz vermerkt dies bei jedem Endpunkt.
Best Practices
Halten Sie Ihr Token sicher. Committen Sie es niemals in die Versionskontrolle. Verwenden Sie Umgebungsvariablen oder einen Secrets-Store
Testen Sie destruktive Aktionen zuerst per Dry Run. Bulk Actions, Tracking-Übermittlungen und Bulk-Mapping-Schreibvorgänge akzeptieren
dryRun. Nutzen Sie dies besonders bei einer filterbasierten Auswahl, bei der ein falscher Filter Tausende Datensätze treffen kannLesen Sie die Ergebnisse pro Zeile. Batch-Endpunkte melden jede Zeile einzeln. Ein 200 bedeutet nicht, dass jede Zeile erfolgreich war
Verwenden Sie Webhooks statt Polling, wenn für Ihren Bedarf ein Event existiert
Behandeln Sie Fehler ordnungsgemäß, einschließlich Rate Limits, Auth-Fehlern und Validierungsfehlern
Testen Sie zuerst an einem einzelnen Datensatz. Besonders bei allem, was einen Käufer erreicht, wie Tracking-Übermittlungen, Helpdesk-Antworten und Angebotsregeln