Delta¶
Über diese API lassen sich die Änderungen an den Stammdaten abfragen. Es können die einzelnen IDs oder auch die passende URL zu den Daten abgefragt werden.
Wenn über 500 Datensätze pro Tabelle geändert wurden , werden nicht mehr als 500IDs zurück gemeldet. Die Url ändert sich in "Daten auslesen". Dann ist es sinnvoller alle Daten zu laden.
Beispiel 2 Datensätze haben sich geändert :
"item": {
"updated": {
"ids": [
1,
2
],
"url": "/api/commerce/item/search?q=item.iid%20IN%20%221,2%22"
}
}
Beispiel 1000 Datensätze haben sich geändert
"item": {
"updated": {
"ids": [
1,
2,
...,
500
],
"url": "/api/commerce/item"
}
}
Parameter¶
Mögliche Paramter
Parameter | Beschreibung | Beispiel |
---|---|---|
fields | welche Felder sollen zurück geliefert werden | ids,url |
filter | welche Objekte sollen zurück geliefert werde | item,text |
fields¶
Mögliche Rückgabe Werte
Feld | Typ | Beschreibung | Beispiel |
---|---|---|---|
ids | array | Liste der IDs die sich geändert haben | [1,500,501,502,1000] |
url | string | URL zu den Daten | /api/commerce/item/search?q=item.iid%20IN%20%221,500,501,502,1000%22 |
filter¶
Hier eine Liste aller unterstützen Delta Apis
Schlüssel | Beschreibung |
---|---|
item | Produkte |
text | Texte |
price | Preise |
stock | Lager |
publishing | Veröffentlichungen |
itemproperty | Produkt Eigenschaften |
order | Bestellungen |
delivery | Lieferungen |
color | Farben |
category | Kategorie |
assignment1 | Zuweisungen 1 |
assignment2 | Zuweisungen 2 |
assignment3 | Zuweisungen 3 |
audience | Zielgruppen |
brand | Marken |
collection | Zusammenstellungen |
department | Abteilungen |
material | Material |
raster | Raster |
season | Saison |
style | Ausführung |
user | Benutzer |
personal | Persönliche Daten des Benutzers |
address | Adressen des Benutzers |
communication | Kontakt Daten des Benutzers |
retoure | Retouren |
voucher | Gutscheine |
store | Stores (Branchenbuch) |
storeproperty | Stores (Branchenbuch) Eigenschaften |
itemstorestock | Stores Produkt Lagerbestände (Branchenbuch) |
Delta abfragen¶
Die URL /api/util/delta/[YYYYMMDDHHIISS]
liefert die IDs zurück die sich seit dem Datum geändert haben.
Das Datum muss in UTC übergeben werden.
Beispiel : /api/util/delta/20180101061722?fields=ids,url
Liefer die Daten seit die neuer sind als "01.01.2018 06:17:22"
{
"dataset": {
"item": {
"updated": {
"ids": [
1
],
"url": "/api/commerce/item/search?q=item.iid%20IN%20%221%22"
}
},
"color": {
"updated": {
"ids": [
1,
29
],
"url": "/api/commerce/item/property/search?q=price.pid%20IN%20%221,29%22"
}
},
"category": {
"deleted": {
"ids": [
47
]
}
}
},
"sys": {
"message": "200 OK",
"code": 200
}
}