✨ Mach mit bei unserem Partnerprogramm

🔌 API-Referenz

💡 Entdecke die Vinted API von Dotb

Dotb bietet eine öffentliche REST-API, mit der du deine Dotb-Abläufe direkt aus deinen eigenen Skripten und Tools automatisieren kannst.

Die API ist im Boutique-AI-Tarif verfügbar.

Was du tun kannst

Der Großteil der API arbeitet mit deinen Daten in Dotb. Einige Aufrufe wirken live auf Vinted, über deine Browser-Erweiterung: siehe Aufrufe, die die Bridge brauchen.

  • Anzeigen in Dotb erstellen — erstelle deine Anzeigen über die API und veröffentliche sie anschließend mit der Browser-Erweiterung auf Vinted.
  • Veröffentlichungen planen — plane die Veröffentlichung von Anzeigen, die in Dotb erstellt und noch nicht auf Vinted sind (mit mindestens einem Foto), zu gewählten Zeiten mit POST /items/schedule (bis zu 250 pro Aufruf). Die Browser-Erweiterung führt jede Veröffentlichung aus, deshalb muss sie laufen (Browser geöffnet, Erweiterung aktiv), sowohl wenn du planst als auch wenn die Veröffentlichung läuft; einmal in der Warteschlange, wartet eine geplante Veröffentlichung und wird erneut versucht, sobald die Erweiterung wieder da ist.
  • Auf deine Vinted-Bestellungen zugreifen — lies die Bestellungen, die Dotb aus deinem Vinted-Konto synchronisiert hat.
  • Deine Kunden nachschlagen — liste die Käufer aus deinen synchronisierten Bestellungen mit Anzahl der Bestellungen und Gesamtumsatz auf und filtere Bestellungen nach Kunde.
  • Per Webhook benachrichtigt werden — registriere bis zu 3 HTTPS-URLs, um Ereignisse (neue Bestellung, Statusänderung einer Bestellung, eröffnete Reklamation, erfolgreiche oder fehlgeschlagene Veröffentlichung, neue Benachrichtigung) als signierte POST-Anfragen nach dem Standard Webhooks-Schema zu erhalten. Verwalte sie unter Einstellungen → API-Tokens oder über die API. Lieber selbst abfragen? Der Feed GET /events liefert dieselben Ereignisse (7 Tage lang gespeichert).
  • Deine Vinted-Unterhaltungen führen — lies Unterhaltungen und Nachrichten, sende Nachrichten und mache oder beantworte Angebote. Diese Aufrufe wirken direkt auf Vinted über deine Browser-Erweiterung, daher muss sie für dieses Vinted-Konto online sein (Browser geöffnet, Erweiterung aktiv); sonst antwortet die API sofort mit 503 und nichts wird in die Warteschlange gestellt.
  • Deine Benachrichtigungen lesen — liste dieselben Benachrichtigungen wie die Glocke im Dashboard auf (Bestellungen, Smart Agent, Captchas, Vinted, Dotb), filtere nach Gruppe, Vinted-Konto oder ungelesen, rufe die Zähler ungelesener ab und markiere sie als gelesen oder ungelesen (GET /notifications, /notifications/counts, /notifications/{id}, POST /notifications/{id}/read, /unread, /notifications/read-all). Titel und Texte kommen in deiner Sprache, oder übergib locale. Webhooks liefern jede neue als notification.created.
  • Deine Live-Artikel sehen und löschen — liste auf, was gerade auf deinem Vinted-Konto ist (jede Anzeige, jeder Entwurf und jeder verkaufte Artikel, GET /accounts/{account_id}/live-items), und lösche Anzeigen, auf Wunsch samt ihrem Dotb-Artikel. Live-Artikel sind die Kurzfassung, die Vinted im Kleiderschrank zeigt; deine Dotb-Artikel enthalten die vollständigen Daten.
  • Deine Live-Bestellungen verfolgen und Reklamationen beantworten — lies eine Vinted-Bestellung so, wie sie gerade auf Vinted ist (GET /accounts/{account_id}/live-orders/{transaction_id}, mit der transaction_id einer Unterhaltung oder der vinted_transaction_id einer Bestellung), sieh die Reklamation des Käufers und beantworte sie: volle Erstattung, Angebot einer Teilerstattung oder Rücksendung. Deine Dotb-Bestellungen (/orders) sind die synchronisierte Kopie.

Aufrufe, die die Bridge brauchen

Live heißt: gerade jetzt auf Vinted gelesen und geändert — Live-Artikel, Live-Bestellungen und Live-Unterhaltungen. Alles andere sind deine Daten in Dotb und funktioniert jederzeit. Live-Aufrufe und einige weitere unten laufen über die Bridge der Dotb-Browser-Erweiterung. Dafür muss dein Browser geöffnet sein, die Erweiterung aktiv und die Bridge für dieses Vinted-Konto aktiviert:

  • Live-Artikel — auflisten und löschen (/accounts/{account_id}/live-items).
  • Live-Bestellungen und ihre Reklamationen — alle Aufrufe unter /accounts/{account_id}/live-orders/….
  • Live-Unterhaltungen — alle Aufrufe unter /accounts/{account_id}/live-conversations/…. Das Hochladen eines Fotos für eine Nachricht (POST /conversation-photos) braucht sie nicht.
  • Versandetiketten — POST /orders/{id}/shipping-label.
  • Geplante Veröffentlichungen — die Bridge muss beim Planen aktiv sein. Die Veröffentlichung selbst wartet auf die Erweiterung, falls sie später offline geht.

Ist die Bridge aus, schlagen diese Aufrufe sofort fehl und nichts wird in eine Warteschlange gestellt (außer bereits angenommenen geplanten Veröffentlichungen). Zum Prüfen vorab liefert GET /accounts für jedes Vinted-Konto bridge.connected.

🔌 So aktivierst du die Bridge

Interaktive Dokumentation

Die vollständige API-Referenz ist öffentlich und interaktiv. Du kannst jeden Endpunkt durchsuchen, die Anfrage- und Antwortschemata einsehen und Aufrufe direkt im Browser ausprobieren.

📖 Interaktive API-Referenz öffnen

Authentifizierung

Jede Anfrage wird mit einem persönlichen API-Token authentifiziert, das als Bearer-Token im Authorization-Header gesendet wird. Ein Boutique-AI-Abonnement ist erforderlich.

Erstelle und verwalte deine Tokens in deinen API-Token-Einstellungen. Behandle sie wie Passwörter — jede Person mit einem Token kann in deinem Namen handeln.

Basis-URL

https://dotb.io/api/public/v1

Für KI-Tools und Codegeneratoren

Eine maschinenlesbare Zusammenfassung der API findest du unter /api/public/v1/llms.txt und die rohe OpenAPI-Spezifikation unter /api/public/v1/openapi.json.