REST API Produktdatenexport V1
Diese Ressource wird für den Export von Produktdaten in Quant verwendet. Das Eingabe- und Ausgabeformat ist JSON.
Verwenden Sie den Dialog Automatische Aufgaben, um einen Export zu erstellen und einzurichten. Nach der Erstellung hat die Aufgabenliste die ID, die Sie in der Anfrage-URL übergeben.
Einstellungen
Bevor Sie die API verwenden, müssen Sie die folgenden Attribute auf der Registerkarte Einstellungen bearbeiten:
- Kreuzen Sie das Attribut Aktiviert an, um die Aufgabe zu aktivieren
- Wählen Sie im Feld Benutzer mit API-Zugriffsberechtigung einen oder mehrere Benutzer mit der Rolle "Roboter" aus, die zur Ausführung der Aufgabe berechtigt sind.
- Wählen Sie unter Produkt Attributzuordnung die zu exportierenden Attribute aus und ändern Sie optional deren JSON-Schlüssel
Attribute
Attribut | Beschreibung | Typ |
Aktiviert | Gibt an, ob die automatische Aufgabe aktiv ist und ob die Daten durch sie gesendet werden können. | ja/nein |
Titel | Eigene Name der automatischen Aufgabe. | Text |
Beschreibung | Benutzerdefinierte Beschreibung der Funktion der automatischen Aufgabe. | Formatierter Text |
Hinweise | Notizen. | Langtext |
E-Mails für Benachrichtigungen | Eine oder mehrere E-Mail-Adressen, an die E-Mails mit Fehlerbedingungen gesendet werden sollen. | Liste von Strings |
Benutzer mit API-Zugangsberechtigung | Benutzer mit der Rolle Roboter, die berechtigt sind, die Aufgabe auszuführen. | Liste der Benutzer |
Maßeinheit | Maßeinheit wie cm, mm usw. | Auswahl |
Datumsformat | Datumseingabeformat, z.B. 31.12.19 | Auswahl |
Datum und Zeitformat | Datumseingabeformat und Uhrzeit, z. B. 31.12.19 23:59:59 | Auswahl |
Produktattribut-Mapping | Ein Mapping mit einem Eintrag für jedes Attribut des platzierten Produkts, das exportiert werden soll. | komplexer Typ |
List Item Separator | Symbol für die Aufteilung der Elemente in der Liste der Werte. | Symbol |
Ausschluss POS | Wenn aktiviert, werden POS-Produkte nicht exportiert. | ja/nein |
Alle Produkte | Wenn aktiviert, werden alle Produkte exportiert. | ja/nein |
Produkte | Filter, der die Liste der zu exportierenden Produkte angibt | komplexer Typ |
Anfrage
/v1/export/product-data/{task_id}
Parameter | Wert |
URL | ?debug, das der URL hinzugefügt wird, zeigt auch eine Warnung in der Antwort an. Ohne diese Option werden nur Fehler angezeigt. |
Kopfzeile | Accept: application/json |
Kopfzeile | Inhaltstyp: application/json |
Kopfzeile | Berechtigung: Bearer <TOKEN> TOKEN wird mit /authenticate (siehe Login) ermittelt. |
Methode | POST |
Der Inhalt der Anfrage kann weggelassen werden (leerer Text), oder er kann ein leeres JSON-Objekt sein.
Antwort
Schlüssel | Wert |
Status | Eine Zeichenfolge, die den endgültigen Zustand des Exports beschreibt.
|
Warnungen | Sie ist optional, d.h. sie wird nur eingefügt, wenn der Parameter ?debug in der URL enthalten ist und der Export mindestens eine Warnung erzeugt hat. Liste der Warnzeichenfolgen. |
Fehler | Optional - nur enthalten, wenn der Export mindestens einen Fehler erzeugt hat. Liste der Fehlerzeichenfolgen. |
Rekorde | Optional - wird nur eingefügt, wenn der Export nicht mit dem Status "FAILURE" beendet wurde. Liste der exportierten Objekte. Jedes Objekt enthält Schlüssel, die durch die Zuordnung in den Auftragseinstellungen definiert sind. |
Status Codes
Status | Wert |
200 OK | Export erfolgreich mit dem Status "SUCCESS" oder "PARTIAL_SUCCESS". Die Antwort kann Warnungen oder kleinere Fehler enthalten. |
400 Bad Request | Fehlerhafte Aufgabeneinstellungen oder falsche Anfrage. |
401 Nicht autorisiert | Das Autorisierungs-Token ist ungültig, oder der Benutzer, der mit dem Token angemeldet ist, hat keine Berechtigung zur Ausführung dieser Aufgabe. |
404 Nicht gefunden | Es wurde keine Aufgabe mit der in der URL angegebenen ID gefunden. |
500 Internal Server Error | Beim Export ist ein kritischer serverseitiger Fehler aufgetreten. |
Ausführungsprotokoll
In Quant können Sie neben den Aufgabeneinstellungen auch Aufzeichnungen zu einzelnen Exporten einsehen, darunter Statistiken, Fehler und Warnungen.
Wenn wir einen bestimmten Datensatz auswählen, können wir seine Details anzeigen, indem wir auf die Schaltfläche Elemente anzeigen klicken.
Anfrage
curl -X POST --location "http://[IHR_COMPANY].iquant.eu/v1/export/product-data/246?debug" \
-H "Authorization: Bearer ywJqq25pXO6oaCPqgEAiTioBVwM8Ih2kOwzzd3eWK3R2oDSA5n" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Cache-Control: no-cache" \
-d '{}'
Antwort
{
"Status": "SUCCESS", "Records": [
{
"Primäre Id": "400020", "Produktname": "Acrylfarbe - grau", "Lieferantenname": "Paleto"
},
{
"Primäre Id": "200062", "Produktname": "Handschuhe - blau", "Lieferantenname": "SportWear",
},
...
}