Katalog-API2026-11Vorschau

Varianten

Eine Option eines Produkts, eine Größe, eine Farbe oder ein Handymodell, verknüpft mit der SKU des Verkäufers, die wir kaufen, und der Variante, die dein Shop verkauft.

Eine Variante ist das, was eine Bestellposition nennt. Ihr Bestand sagt, wie viele du verkaufen kannst.

Endpunkte

GET/v1/products/{id}/variantsVarianten eines Produkts auflisten
GET/v1/variants/{id}Eine Variante abrufen
PATCH/v1/variants/{id}Eine Variante aktualisieren

Das Variant-Objekt

idstring: Beginnt mit var_.
skustring: Die SKU des Verkäufers, wie wir sie gelesen haben. Das, was wir kaufen.
label, options: Die Optionswerte, als eine Bezeichnung und nach Optionsname.
costmoney: Was der Verkäufer für ein Stück berechnet, in CN¥, wie zuletzt gelesen.
pricemoney: Dein Verkaufspreis.
in_stockboolean: Ob der Verkäufer es verkaufen kann, wie zuletzt gelesen.
unitsinteger: Wie viele wir für jedes verkaufte Stück kaufen: Ein 3er-Pack in deinem Shop kauft 3.
weight_ginteger: Das verpackte Gewicht, das du für ein Stück angegeben hast, um den Versand zu schätzen.
external_variant_idstring|null: Die Variante deines Shops. Eine Bestellung dafür kauft diese SKU; eine Bestellung für eine nicht zugeordnete Variante wird abgelehnt.

variant

{
  "id": "var_41hz",
  "product": "prd_8f2k",
  "sku": "5187209554",
  "label": "Black / M",
  "options": { "Color": "Black", "Size": "M" },
  "image": "https://media.ninjabuy.com/listings/weidian-7750970856/sku-black.webp",
  "cost": { "amount": "38.00", "currency": "CNY" },
  "price": { "amount": "49.99", "currency": "USD" },
  "in_stock": true,
  "units": 1,
  "weight_g": 180,
  "external_variant_id": "gid://shopify/ProductVariant/44100231",
  "updated_at": "2026-11-04T09:20:03Z"
}

Varianten eines Produkts auflisten

GET/v1/products/{id}/variants

Jede Variante mit ihren Kosten, deinem Preis, Bestand und ihrer Zuordnung.

Scopeproducts:read

Pfadparameter

idstringerforderlich: Die ID des Produkts.

Query-Parameter

limit, cursor: Pagination

Fehler

Status	Typ	Wann
404	not-found	Kein solches Produkt in diesem Konto.

curl "https://www.ninjabuy.com/api/v1/products/prd_8f2k/variants" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11"

Response 200

HTTP/2 200 OK

{
  "data": [
    {
      "id": "var_41hz",
      "product": "prd_8f2k",
      "sku": "5187209554",
      "label": "Black / M",
      "options": { "Color": "Black", "Size": "M" },
      "image": "https://media.ninjabuy.com/listings/weidian-7750970856/sku-black.webp",
      "cost": { "amount": "38.00", "currency": "CNY" },
      "price": { "amount": "49.99", "currency": "USD" },
      "in_stock": true,
      "units": 1,
      "weight_g": 180,
      "external_variant_id": "gid://shopify/ProductVariant/44100231",
      "updated_at": "2026-11-04T09:20:03Z"
    },
    {
      "id": "var_41j0",
      "product": "prd_8f2k",
      "sku": "5187209555",
      "label": "Black / L",
      "options": { "Color": "Black", "Size": "M" },
      "image": "https://media.ninjabuy.com/listings/weidian-7750970856/sku-black.webp",
      "cost": { "amount": "38.00", "currency": "CNY" },
      "price": { "amount": "49.99", "currency": "USD" },
      "in_stock": false,
      "units": 1,
      "weight_g": 180,
      "external_variant_id": null,
      "updated_at": "2026-11-04T09:20:03Z"
    }
  ],
  "has_more": false,
  "cursor": null
}

Eine Variante abrufen

GET/v1/variants/{id}

Eine Variante.

Scopeproducts:read

Pfadparameter

idstringerforderlich: Die ID der Variante.

Fehler

Status	Typ	Wann
404	not-found	Keine solche Variante in diesem Konto.

curl "https://www.ninjabuy.com/api/v1/variants/var_41hz" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11"

Response 200

HTTP/2 200 OK

{
  "id": "var_41hz",
  "product": "prd_8f2k",
  "sku": "5187209554",
  "label": "Black / M",
  "options": { "Color": "Black", "Size": "M" },
  "image": "https://media.ninjabuy.com/listings/weidian-7750970856/sku-black.webp",
  "cost": { "amount": "38.00", "currency": "CNY" },
  "price": { "amount": "49.99", "currency": "USD" },
  "in_stock": true,
  "units": 1,
  "weight_g": 180,
  "external_variant_id": "gid://shopify/ProductVariant/44100231",
  "updated_at": "2026-11-04T09:20:03Z"
}

Eine Variante aktualisieren

PATCH/v1/variants/{id}

Leg ihren Preis fest, die pro Verkauf gekauften Stück, ihr Gewicht oder die Shop-Variante, für die sie steht. Schick nur, was sich ändert.

Scopeproducts:write

Pfadparameter

idstringerforderlich: Die ID der Variante.

Body

pricemoney: Optional. Dein Verkaufspreis.
unitsinteger: Optional. 1 bis 50.
weight_ginteger: Optional. Verpacktes Gewicht eines Stücks, in Gramm.
external_variant_idstring|null: Optional. Ordne sie einer Variante in deinem Shop zu, oder null, um die Zuordnung aufzuheben.

Fehler

Status	Typ	Wann
404	not-found	Keine solche Variante in diesem Konto.
409	invalid-state	Diese Shop-Variante steht schon für eine andere SKU.

curl -X PATCH "https://www.ninjabuy.com/api/v1/variants/var_41hz" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11" \
  -H "Content-Type: application/json" \
  -d '{
    "units": 2,
    "price": { "amount": "89.99", "currency": "USD" }
  }'

Response 200

HTTP/2 200 OK

{
  "id": "var_41hz",
  "product": "prd_8f2k",
  "sku": "5187209554",
  "label": "Black / M",
  "options": { "Color": "Black", "Size": "M" },
  "image": "https://media.ninjabuy.com/listings/weidian-7750970856/sku-black.webp",
  "cost": { "amount": "38.00", "currency": "CNY" },
  "price": { "amount": "89.99", "currency": "USD" },
  "in_stock": true,
  "units": 2,
  "weight_g": 180,
  "external_variant_id": "gid://shopify/ProductVariant/44100231",
  "updated_at": "2026-11-04T09:20:03Z"
}