Katalog API'si2026-11Önizleme

Varyantlar

Bir ürünün tek bir seçeneği; bir beden, bir renk ya da bir telefon modeli; satın aldığımız satıcı SKU'suna ve mağazanızın sattığı varyanta bağlıdır.

Varyant, bir sipariş satırının belirttiği şeydir. Stok seviyesi kaç adet satabileceğinizi söyler.

Uç noktalar

GET/v1/products/{id}/variantsBir ürünün varyantlarını listele
GET/v1/variants/{id}Varyantı getir
PATCH/v1/variants/{id}Varyantı güncelle

Variant nesnesi

idstring: var_ ile başlar.
skustring: Okuduğumuz hâliyle satıcının SKU'su. Satın aldığımız şey.
label, options: Seçenek değerleri; tek bir etiket olarak ve seçenek adına göre.
costmoney: Satıcının bir adet için istediği, CN¥ cinsinden, son okunduğu hâliyle.
pricemoney: Satış fiyatınız.
in_stockboolean: Son okunduğu hâliyle satıcının onu satıp satamayacağı.
unitsinteger: Sattığınız her biri için kaç adet satın aldığımız: mağazanızdaki 3'lü paket 3 adet satın alır.
weight_ginteger: Bir adet için verdiğiniz paketli ağırlık; kargoyu tahmin etmek için kullanılır.
external_variant_idstring|null: Mağazanızın varyantı. Onun için gelen bir sipariş bu SKU'yu satın alır; eşlenmemiş bir varyant için gelen sipariş reddedilir.

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"
}

Bir ürünün varyantlarını listele

GET/v1/products/{id}/variants

Maliyeti, fiyatınız, stoğu ve eşlemesiyle her varyant.

Kapsamproducts:read

Yol parametreleri

idstringzorunlu: Ürünün id'si.

Sorgu parametreleri

limit, cursor: Pagination

Hatalar

Durum	Tür	Ne zaman
404	not-found	Bu hesapta böyle bir ürün yok.

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
}

Varyantı getir

GET/v1/variants/{id}

Tek bir varyant.

Kapsamproducts:read

Yol parametreleri

idstringzorunlu: Varyantın id'si.

Hatalar

Durum	Tür	Ne zaman
404	not-found	Bu hesapta böyle bir varyant yok.

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"
}

Varyantı güncelle

PATCH/v1/variants/{id}

Fiyatını, satış başına satın alınan adedi, ağırlığını ya da karşılık geldiği mağaza varyantını ayarlayın. Yalnızca değişeni gönderin.

Kapsamproducts:write

Yol parametreleri

idstringzorunlu: Varyantın id'si.

Gövde

pricemoney: İsteğe bağlı. Satış fiyatınız.
unitsinteger: İsteğe bağlı. 1 ile 50 arası.
weight_ginteger: İsteğe bağlı. Bir adedin paketli ağırlığı, gram cinsinden.
external_variant_idstring|null: İsteğe bağlı. Mağazanızdaki bir varyantla eşleyin ya da eşlemeyi kaldırmak için null.

Hatalar

Durum	Tür	Ne zaman
404	not-found	Bu hesapta böyle bir varyant yok.
409	invalid-state	Bu mağaza varyantı zaten başka bir SKU'ya karşılık geliyor.

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"
}