REST Kategorien

Filtermöglichkeiten:

Mit dem Request-Parameter "filter[parentIndex]" kann nach dem Index der Oberkategorie gefiltert werden, Beispiel:

filter[parentIndex]=123

Wird für diesen Parameter ein leerer Wert angegeben, so werden die Kategorien unterhalb der "Root" (d.h. die oberste Ebene des Kategoriebaums) zurückgeliefert.

Bei dem Request-Parameter "subshop" muss der Subshop angegeben werden, Beispiel:

subshop=01-aa

Limit:

Die Anzahl der zurückgegebenen Kategorien kann mit dem Parameter "size" beschränkt werden, Beispiel:

size=100

Sortierung:

Die Sortierung wird mit dem Parameter "sort" angegeben, es sind die Werte "predefined" (Reihenfolge wie sie im Shop angezeigt wird) und "catIndex" (aufsteigend nach Kategorieindex) erlaubt, Beispiel:

sort=predefined

Beispiele:

// Zugriff auf bis zu 100 Unterkategorien von Kategorie 123
GET https://www.websale.de/api/categories/?filter[parentIndex]=123&size=100&subshop=deutsch

GET https://www.websale.de/api/categories/?filter[parentIndex]=123&size=100&sort=predefined&subshop=deutsch

// Toplevel Kategorien
GET https://www.websale.de/api/categories/categories?filter[parentIndex]=&size=100&subshop=deutsch
 

application/json

Authorization-Token

benötigt

Response

Liefert im Erfolgsfall eine Liste mit Kategorien.

Beispiel:

{
    "totalCount": 1000, // Anzahl der Ergebnisse wenn size nicht greifen würde
    "items": [
        {
            "parentIndex": "1337",
            "catIndex": "123",
            "name": "Erste Kategorie",
            "hasChildren": true,
            "hreflang": [
				{"catIndex": "456", "subshop": "Deutsch"}, {"catIndex": "457", "subshop": "07-aa"}
			]},
        ...
    ]
}