Kategorien-API

Verwalten Sie Ihre Produktkategorien mit Unterstuetzung fuer verschachtelte Hierarchien.

Endpunkte

GET

/categories

categories:read

Eine flache Liste aller Kategorien abrufen.

GET

/categories/tree

categories:read

Den vollstaendigen Kategoriebaum mit verschachtelten Unterkategorien abrufen.

GET

/categories/:id

categories:read

Eine einzelne Kategorie anhand ihrer ID abrufen.

POST

/categories

categories:write

Eine neue Kategorie erstellen. Setzen Sie parentId, um eine Unterkategorie zu erstellen.

PUT

/categories/:id

categories:write

Eine bestehende Kategorie aktualisieren. Teilaktualisierungen werden unterstuetzt.

DELETE

/categories/:id

categories:write

Weiches Loeschen einer Kategorie. Produkte in dieser Kategorie sind nicht betroffen.

Feldreferenz

Feld	Typ	Erforderlich	Beschreibung
id	string	Nein	Eindeutige Kategorie-ID (schreibgeschuetzt)
name	string	Ja	Kategoriename
slug	string	Nein	URL-freundlicher Slug (automatisch generiert, wenn nicht angegeben)
description	string	Nein	Kategoriebeschreibung
parentId	string	Nein	ID der uebergeordneten Kategorie fuer Verschachtelung
imageUrl	string	Nein	URL des Kategoriebildes
sortOrder	integer	Nein	Anzeigereihenfolge (niedriger = zuerst)
isActive	boolean	Nein	Ob die Kategorie aktiv ist (Standard: true)
children	Category[]	Nein	Verschachtelte Unterkategorien (nur im Baum-Endpunkt)
createdAt	datetime	Nein	ISO 8601 Zeitstempel (schreibgeschuetzt)
updatedAt	datetime	Nein	ISO 8601 Zeitstempel (schreibgeschuetzt)

Beispiel

Kategoriebaum abrufen

bash

curl "https://api.mercozy.com/api/v1/external/categories/tree" \
  -H "X-API-Key: mk_live_xxxxx"

Eine Kategorie erstellen

bash

curl -X POST "https://api.mercozy.com/api/v1/external/categories" \
  -H "X-API-Key: mk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Electronics",
    "description": "Electronic devices and accessories",
    "sortOrder": 1,
    "isActive": true
  }'

Beispielantwort (Baum)

json

{
  "data": [
    {
      "id": "cat_abc123",
      "name": "Electronics",
      "slug": "electronics",
      "description": "Electronic devices and accessories",
      "parentId": null,
      "imageUrl": null,
      "sortOrder": 1,
      "isActive": true,
      "children": [
        {
          "id": "cat_def456",
          "name": "Smartphones",
          "slug": "smartphones",
          "description": "Mobile phones",
          "parentId": "cat_abc123",
          "imageUrl": null,
          "sortOrder": 1,
          "isActive": true,
          "children": []
        }
      ],
      "createdAt": "2025-12-15T10:30:00Z",
      "updatedAt": "2025-12-15T10:30:00Z"
    }
  ]
}