Zum Hauptinhalt springen

Produkte

Rufen Sie eine paginierte Liste der in einem bestimmten Shop verfügbaren Produkte ab, gefiltert nach Markt.

Produkte auflisten

GET /v2/public/products/{shop_identifier}
shop_identifier
string
erforderlich
Eindeutiger Bezeichner für den Shop
market
string
erforderlich
Marktbezeichner (z. B. DE für Deutschland)
Produkte und SKUs nach Name filtern
page
integer
Standard:"0"
Seitennummer (0-basiert)
limit
integer
Standard:"50"
Ergebnisse pro Seite (max. 150)
Erforderliche Berechtigung: product:read

Beispielanfrage

curl -X GET "https://api.rxscale.com/v2/public/products/my-shop?market=DE&page=0&limit=25" \
  -H "X-API-Key: your-api-key-here"

Antwort

{
  "data": [
    {
      "uid": "prod-abc123",
      "display_name": "Medication X",
      "attributes": [
        {
          "key": "category",
          "value": "Pain Relief"
        }
      ],
      "skus": [
        {
          "uid": "sku-456",
          "display_name": "Medication X 100mg",
          "pzn": "12345678",
          "price": 1299
        },
        {
          "uid": "sku-789",
          "display_name": "Medication X 200mg",
          "pzn": "87654321",
          "price": 1999
        }
      ]
    }
  ],
  "totalRegistries": 42,
  "totalPages": 2
}

Antwortfelder

FeldTypBeschreibung
dataarrayListe der Produktobjekte
data[].uidstringProdukt-UID
data[].display_namestringAnzeigename des Produkts
data[].attributesarrayProduktattribute (Schlüssel-Wert-Paare)
data[].skusarrayVerfügbare SKUs für dieses Produkt im angegebenen Markt
data[].skus[].uidstringSKU-UID (verwenden Sie diese beim Erstellen von Checkouts)
data[].skus[].pznstringPharmazentralnummer
data[].skus[].priceintegerPreis in Euro-Cent
totalRegistriesintegerGesamtanzahl der übereinstimmenden Produkte
totalPagesintegerGesamtanzahl der Seiten

Fehlerantworten

StatuscodeBeschreibung
400Fehlender market-Abfrageparameter
404Shop nicht gefunden