Mehrsprachige Kurz- und Langtexte gehören zu den am häufigsten aktualisierten Produktdaten – etwa wenn ein Übersetzungsdienstleister (z. B. via DeepL) neue Sprachversionen liefert oder ein Texting-Workflow in n8n automatisch SEO-Texte erzeugt. Die ComBinder REST API bietet dafür einen eigenen Endpunktbereich, der Kurz- und Langtexte je Sprache einzeln lesen, setzen und löschen kann.
Voraussetzungen
- Die REST API ist aktiviert (Einstellungen → REST API → „REST API aktivieren") und ein Workspace ist geöffnet.
- Ein gültiges Bearer-Token aus
POST /api/auth/login.
Endpunkte im Überblick
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | /api/product/{id}/texts/short | Alle Kurztexte (alle Sprachen) eines Produkts |
| GET | /api/product/{id}/texts/short/{lang} | Kurztext für eine Sprache |
| PUT | /api/product/{id}/texts/short/{lang} | Kurztext setzen (Upsert) |
| DELETE | /api/product/{id}/texts/short/{lang} | Kurztext löschen |
| GET / PUT / DELETE | /api/product/{id}/texts/long/... | Analog für Langtexte |
Beispiel: Kurztext auf Deutsch setzen
PUT /api/product/123/texts/short/deu
Authorization: Bearer <token>
Content-Type: application/json
{
"value": "Akku-Bohrschrauber 18V mit 2x 4Ah Akku"
}Existiert für die Sprache bereits ein Text, wird er überschrieben (Upsert). Existiert noch keiner, legt ComBinder den Eintrag neu an – ein separater „Create"-Aufruf ist nicht nötig.
Alle Sprachen abrufen
GET /api/product/123/texts/long
Authorization: Bearer <token>Die Antwort liefert ein Array aus Sprachkürzel (dreistellig, z. B. deu, eng) und Wert – ideal, um in einem Automatisierungs-Workflow zu prüfen, für welche Sprachen noch Texte fehlen.
Löschen
DELETE /api/product/{id}/texts/short/{lang} entfernt nur den Text der angegebenen Sprache; das Produkt selbst und Texte anderer Sprachen bleiben unberührt. Existiert kein Text für die Sprache, liefert ComBinder 404.
Typischer Anwendungsfall
In einem n8n-Workflow lassen sich neue oder geänderte Produkte regelmäßig über GET /api/product ermitteln, die fehlenden Sprachtexte über GET /api/product/{id}/texts/short identifizieren und anschließend automatisiert per KI-Übersetzung (z. B. DeepL) befüllen und über PUT zurückschreiben.