Entwickler

Die öffentliche API von ControlResell

Automatisieren Sie Ihr Geschäft mit eigenen Skripten und Tools: Lesen Sie Ihre Konten, Artikel und Unterhaltungen mit einem API-Schlüssel.

Die öffentliche API wird gerade eingeführt. Sie ist Abos vorbehalten, die sie enthalten, und wird schrittweise freigeschaltet: Die Seite zur Schlüsselverwaltung ist noch nicht in jedem Konto sichtbar. Ohne Zugang antwortet die API mit dem Fehler 402.

API-Schlüssel erstellen

Schlüssel werden in der App mit Ihrer Sitzung erstellt. Ein Schlüssel kann keine anderen Schlüssel erstellen, auflisten oder widerrufen.

  1. Melden Sie sich in der ControlResell-Web-App an.
  2. Öffnen Sie Einstellungen, dann Entwickler.
  3. Erstellen Sie einen Schlüssel: Vergeben Sie einen Namen, wählen Sie mindestens einen Bereich und optional ein Ablaufdatum (höchstens 5 Jahre).
  4. Kopieren Sie das Geheimnis sofort: Es wird nur ein einziges Mal angezeigt.

Meine API-Schlüssel verwalten

Das Geheimnis beginnt mit cr_live_. Behandeln Sie es wie ein Passwort: ControlResell speichert nur einen Hash und kann es nicht erneut anzeigen. Im Zweifel widerrufen Sie den Schlüssel und erstellen einen neuen.

Senden Sie den Schlüssel im Authorization-Header jedes Aufrufs. Beispiel zum Lesen Ihres Profils:

curl https://api.controlresell.com/api/public/v1/me \
  -H "Authorization: Bearer cr_live_..."

Sie können höchstens 10 aktive Schlüssel haben, jeder jederzeit widerrufbar.

Verfügbare Bereiche

  • accounts:read – Marktplatz-Konten lesen
  • items:read – Artikel und ihre Anzeigen lesen
  • items:write – Artikel schreiben
  • orders:read – Bestellungen lesen
  • conversations:read – Unterhaltungen lesen
  • conversations:write – Unterhaltungen schreiben

API-Dokumentation

Die interaktive Referenz (Swagger) und die OpenAPI-Spezifikation sind öffentlich und werden aus der Produktions-API erzeugt.

Die API ist versioniert (/api/public/v1). v1 wird nur durch Ergänzungen erweitert; bei einem Bruch wird v2 geöffnet und v1 bleibt nach der Ankündigung mindestens zwölf Monate verfügbar.

Offizielle SDKs und CLI

Aus der Spezifikation erzeugte SDKs und eine CLI, Open Source auf GitHub.

Die Pakete sind noch nicht veröffentlicht: bald auf npm, PyPI und Maven Central. Bis dahin ist der Quellcode auf GitHub verfügbar.