Produkte-API

Erstellen, lesen, aktualisieren und loeschen Sie Produkte in Ihrem Katalog.

Endpunkte

GET

/products

products:read

Erhalten Sie eine paginierte Produktliste. Unterstuetzt Filterung nach Status, Kategorie und Suche.

GET

/products/:id

products:read

Erhalten Sie ein einzelnes Produkt anhand seiner ID.

POST

/products

products:write

Erstellen Sie ein neues Produkt in Ihrem Katalog.

PUT

/products/:id

products:write

Aktualisieren Sie ein bestehendes Produkt. Teilaktualisierungen werden unterstuetzt.

DELETE

/products/:id

products:write

Weiches Loeschen eines Produkts. Kann innerhalb von 30 Tagen wiederhergestellt werden.

Feldreferenz

Feld	Typ	Erforderlich	Beschreibung
id	string	Nein	Eindeutige Produkt-ID (schreibgeschuetzt)
sku	string	Ja	Bestandseinheit
name	string	Ja	Produktname
description	string	Nein	Produktbeschreibung (HTML erlaubt)
barcode	string	Nein	Primärer Produktbarcode (UPC/EAN)
brand	string	Nein	Produktmarkenname
categoryId	string	Nein	Kategorie-ID
unitPrice	integer	Ja	Preis in Cent (z.B. 1999 = $19,99)
normalPrice	integer	Nein	Normalpreis / Listenpreis in Cent (zur Rabattanzeige)
purchasePrice	integer	Nein	Einkaufspreis / Kosten in Cent
weight	string	Nein	Gewicht in Gramm
isActive	boolean	Nein	Ob das Produkt aktiv / veröffentlicht ist (Standard: true)
stockTotal	integer	Nein	Gesamtbestand in allen Lagern (schreibgeschützt)
images	string[]	Nein	Produktbild-URLs
createdAt	datetime	Nein	ISO 8601 Zeitstempel (schreibgeschuetzt)
updatedAt	datetime	Nein	ISO 8601 Zeitstempel (schreibgeschuetzt)

Abfrageparameter (Liste)

Feld	Typ	Erforderlich	Beschreibung
page	integer	Nein	Seitennummer (Standard: 1)
limit	integer	Nein	Elemente pro Seite (Standard: 20, Max: 100)

Beispiel

Produkte mit Paginierung auflisten

bash

curl "https://api.mercozy.com/api/v1/external/products?page=1&limit=10" \
  -H "X-API-Key: mk_live_your_key_here"

Ein Produkt erstellen

bash

curl -X POST "https://api.mercozy.com/api/v1/external/products" \
  -H "X-API-Key: mk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "sku": "WDG-001",
    "name": "Premium Widget",
    "unitPrice": 2999,
    "normalPrice": 3999,
    "brand": "Acme Corp",
    "isActive": true
  }'