ComBinder REST API – Alle Endpunkte im Überblick

Referenz für Automatisierungen mit n8n, Make, Zapier oder eigenen Skripten

Einleitung

Die ComBinder REST API ermöglicht es, zentrale Funktionen der PIM-Software von außen anzusteuern – ohne Mausklicks, vollautomatisch. Ob Produktdaten pflegen, Workspaces wechseln oder Sessions verwalten: Alle Aktionen lassen sich über einfache HTTP-Anfragen ausführen.

Dieser Beitrag dient als wachsende Referenz. Neue Endpunkte werden hier laufend ergänzt, sobald sie verfügbar sind.

Grundlagen

Basis-URL

http://<hostname>:8765

Der Standard-Port ist 8765 und kann in den ComBinder-Einstellungen unter dem Reiter REST API geändert werden.

Authentifizierung

Alle Endpunkte – außer /api/auth/login – erfordern einen Bearer-Token im Authorization-Header:

Authorization: Bearer <token>

Den Token erhaltet ihr beim Login (siehe unten). Er ist 24 Stunden gültig und kann jederzeit manuell per Logout ungültig gemacht werden.

Antwortformat

Alle Antworten folgen einem einheitlichen JSON-Wrapper:

// Erfolg
{ "success": true, "data": { ... } }

// Fehler
{ "success": false, "error": "Fehlermeldung" }

Endpunkte

Authentifizierung

`POST /api/auth/login`

Meldet einen ComBinder-Benutzer an und gibt einen Bearer-Token zurück.

Request-Body:

{
  "username": "n8n-user",
  "password": "geheimes-passwort"
}

Antwort (200):

{
  "success": true,
  "data": {
    "token": "550e8400-e29b-41d4-a716-446655440000",
    "username": "n8n-user",
    "role": "USER"
  }
}

Mögliche Fehler:

Status	Bedeutung
400	username oder password fehlt
401	Ungültige Anmeldedaten
401	Benutzer ist bereits auf einer anderen Instanz eingeloggt

`POST /api/auth/logout`

Meldet den aktuellen Benutzer ab und macht den Token ungültig.

Header: Authorization: Bearer <token>

Antwort (200):

{ "success": true }

Der Logout schließt die Benutzersitzung in ComBinder vollständig – inklusive der Desktop-Session.

Workspaces

`GET /api/workspace`

Gibt alle verfügbaren Workspaces zurück.

Header: Authorization: Bearer <token>

Antwort (200):

{
  "success": true,
  "data": [
    { "id": 1, "name": "Hauptkatalog", "rootpath": "C:/workspaces/haupt", "active": true },
    { "id": 2, "name": "Archiv 2023",  "rootpath": "C:/workspaces/archiv", "active": false }
  ]
}

`POST /api/workspace/open`

Öffnet einen Workspace. Der Vorgang kann bis zu 60 Sekunden dauern; ComBinder lädt dabei alle Produktdaten.

Header: Authorization: Bearer <token>

Request-Body (Name oder ID angeben):

{ "workspaceName": "Hauptkatalog" }
// oder
{ "workspaceId": 1 }

Antwort (200):

{
  "success": true,
  "data": { "id": 1, "name": "Hauptkatalog", "rootpath": "...", "active": true }
}

Mögliche Fehler:

Status	Bedeutung
400	Workspace konnte nicht geladen werden (z. B. Ordner fehlt)
404	Workspace nicht gefunden
504	Timeout – Laden hat länger als 60 Sekunden gedauert

Produkte

`GET /api/product`

Listet alle Masterprodukte des geöffneten Workspace auf.

Header: Authorization: Bearer <token>

Query-Parameter:

Parameter	Wert	Beschreibung
`all`	`true`	Gibt auch Varianten zurück

Antwort (200):

{
  "success": true,
  "data": [
    {
      "id": 101,
      "supplierPid": "ART-001",
      "supplierIdRef": "LIEFERANT-X",
      "name": "Roter Stuhl",
      "ean": "4012345678901",
      "manufacturerPid": "MFR-99",
      "masterProduct": true,
      "variantCount": 3,
      "masterProductId": null
    }
  ]
}

`GET /api/product/{id}`

Gibt ein einzelnes Produkt anhand seiner internen DB-ID zurück.

Header: Authorization: Bearer <token>

Antwort (200): Einzelnes Produkt-Objekt (gleiche Struktur wie oben).

Mögliche Fehler:

Status	Bedeutung
404	Produkt nicht gefunden
409	Kein Workspace geöffnet

`POST /api/product`

Legt ein neues Produkt an.

Header: Authorization: Bearer <token>

Request-Body:

{
  "supplierPid": "ART-002",
  "supplierIdRef": "LIEFERANT-X",
  "name": "Blauer Stuhl",
  "language": "deu",
  "ean": "4099999000001",
  "manufacturerPid": "MFR-100",
  "masterProductId": null
}

Feld	Pflicht	Beschreibung
`supplierPid`	✅	Artikelnummer
`supplierIdRef`	–	Lieferanten-Referenz
`name`	–	Produktname
`language`	–	Sprachcode (z. B. `deu`, `eng`). Standard: Workspace-Sprache
`ean`	–	EAN / GTIN
`manufacturerPid`	–	Hersteller-Artikelnummer
`masterProductId`	–	DB-ID des Masterprodukts → legt Produkt als Variante an

Antwort (201): Das neu angelegte Produkt-Objekt.

`PUT /api/product/{id}`

Aktualisiert ein bestehendes Produkt. Es werden nur die Felder überschrieben, die im Request-Body enthalten sind (Partial Update).

Header: Authorization: Bearer <token>

Request-Body (alle Felder optional):

{
  "name": "Blauer Stuhl – überarbeitet",
  "ean": "4099999000002"
}

Antwort (200): Das aktualisierte Produkt-Objekt.

`DELETE /api/product/{id}`

Löscht ein Produkt dauerhaft.

Header: Authorization: Bearer <token>

Antwort (200):

{ "success": true }

`GET /api/product/{id}/variants`

Gibt alle Varianten eines Masterprodukts zurück.

Header: Authorization: Bearer <token>

Antwort (200): Liste von Produkt-Objekten (gleiche Struktur wie GET /api/product).

`POST /api/product/{id}/variants`

Legt eine neue Variante für ein bestehendes Masterprodukt an.

Header: Authorization: Bearer <token>

Request-Body:

{
  "supplierPid": "ART-001-ROT",
  "name": "Roter Stuhl – Variante",
  "language": "deu"
}

Antwort (201): Das neu angelegte Varianten-Objekt mit gesetzter masterProductId.

HTTP-Statuscodes – Kurzreferenz

Code	Bedeutung
200	Erfolg
201	Ressource erfolgreich angelegt
400	Ungültige Anfrage (fehlende oder falsche Felder)
401	Nicht authentifiziert / Token abgelaufen
404	Ressource nicht gefunden
405	HTTP-Methode nicht erlaubt
409	Konflikt (z. B. kein Workspace geöffnet)
500	Interner Serverfehler
504	Timeout

Endpunkte auf einen Blick

Methode	Pfad	Beschreibung
`POST`	`/api/auth/login`	Login
`POST`	`/api/auth/logout`	Logout
`GET`	`/api/workspace`	Workspaces auflisten
`POST`	`/api/workspace/open`	Workspace öffnen
`GET`	`/api/product`	Produkte auflisten
`POST`	`/api/product`	Produkt anlegen
`GET`	`/api/product/{id}`	Produkt abrufen
`PUT`	`/api/product/{id}`	Produkt aktualisieren
`DELETE`	`/api/product/{id}`	Produkt löschen
`GET`	`/api/product/{id}/variants`	Varianten auflisten
`POST`	`/api/product/{id}/variants`	Variante anlegen

Weiterführende Artikel

SEO-Metadaten

Title Tag

ComBinder REST API – Alle Endpunkte im Überblick (Produkte, Workspaces, Auth) | ComBinder

(~87 Zeichen)

Meta Description

Vollständige Referenz der ComBinder REST API: Login, Workspace-Steuerung und 
Produkt-CRUD mit allen Endpunkten, Request-Beispielen und Statuscodes.

(~155 Zeichen)

URL Slug

/blog/combinder-rest-api-endpunkte-referenz

Primäre Keywords

Keyword	Suchintention
ComBinder REST API Endpunkte	Referenz
ComBinder API Dokumentation	Informational
ComBinder Produkte API	Feature-spezifisch
ComBinder PIM Schnittstelle	Kategorie
ComBinder API Referenz	Informational

Interne Verlinkungsempfehlungen

Zielseite	Ankertextvorschlag
Blog: n8n-Automatisierung	„n8n-Guide mit fertigem Workflow“
Blog: Einstellungen & Monitor	„REST API aktivieren und überwachen“
ComBinder Download	„aktuelle ComBinder-Version”