Merkmale per API importieren

Datenblattwerte aus einer eigenen Datenquelle automatisch bei deinen Produkten eintragen – ohne gepflegte Werte zu überschreiben.

Hast du Datenblattwerte in einer eigenen Quelle, etwa eine Liste zertifizierter Geräte mit Funkstandard und Version, kannst du sie automatisch bei deinen Produkten eintragen lassen. Das geht mit einem eigenen Programm über die API – du musst die Werte nicht von Hand tippen.

Vorbereitung

Lege wie unter „Eigene Apps (API-Clients)“ beschrieben einen API-Client an.
Wähle bei den Scopes „Produktmerkmale importieren (Datenblattwerte schreiben)“.
Erzeuge einen Key und kopiere ihn sofort – er wird nur beim Erzeugen angezeigt.

Keys von Websites können keine Merkmale schreiben, nur Keys von API-Clients mit diesem Scope.

So funktioniert der Import

Dein Programm schickt je Produkt die Merkmale als Liste aus Merkmal und Wert, dazu den Namen deiner Quelle (zum Beispiel `csa-dcl-import`) und optional einen Hinweis wie „CSA DCL, Stand 2026-10-27“. Das Produkt gibst du mit seiner affilinode-ID oder mit einer Kennung an (zum Beispiel `mpn:marke/modellnummer`). In einem Aufruf lassen sich bis zu 100 Produkte übertragen.

Jeder Wert wird so geprüft wie bei der Pflege im Dashboard: Das Merkmal muss zur Produktart des Produkts gehören, der Wert zum Typ des Merkmals passen, Auswahlwerte müssen existieren und Einheiten stimmen. Bei Auswahlmerkmalen werden gängige Schreibweisen erkannt, etwa „Wi-Fi“ für WLAN.

Was der Import überschreibt – und was nie

**Leere Merkmale** füllt der Import.
**Werte aus derselben Quelle** aktualisiert er, wenn sich die Daten ändern.
**Von Hand gepflegte Werte** und Werte, die aus Datenblättern oder der Anreicherung stammen, überschreibt er nie.
Umgekehrt dürfen deine Pflege im Dashboard und die Datenblatt-Auslese jeden importierten Wert jederzeit ersetzen.

Titel, Preise, Bilder und Kennungen berührt der Import nicht. Du kannst denselben Aufruf gefahrlos wiederholen: Bereits eingetragene Werte bleiben unverändert.

Das Ergebnis

Die Antwort nennt je Produkt und Merkmal, was passiert ist:

„applied“ – der Wert wurde eingetragen.
„unchanged“ – der Wert war schon so vorhanden.
„skipped_existing“ – es gibt bereits einen anderen Wert, er wurde nicht angetastet.
„invalid“ – der Wert wurde abgelehnt, mit Grund.
„not_found“ – das Produkt gibt es in deinem Konto nicht.

Dazu kommen Zähler über alle Einträge. Ein fehlerhafter Eintrag hindert die übrigen nicht.

Beispiel

Matter-Daten eines Geräts, übertragen als ein Produkt:

                  {
  "values": {
    "radio_protocols": ["thread", "wi-fi"],
    "matter_version": "1.4",
    "matter_device_type": 266,
    "matter_certificate": "CSA264OFMAT55471-24",
    "matter_certified_since": "2024-03-15",
    "matter_firmware": "1.2.3"
  },
  "source": "csa-dcl-import",
  "sourceNote": "CSA DCL, Stand 2026-10-27"
}

Die eingetragenen Werte erscheinen im Datenblatt, im Vergleich und, wo du sie nutzt, in Filtern und Kaufberatern. Die genaue Beschreibung aller Routen findest du in der API-Dokumentation.