Katalog API'si2026-11Önizleme

Stok seviyeleri

Bir varyanttan şu anda kaç adet satabileceğiniz: satıcının Çin'deki stoğu ve depomuzda tuttuklarınız.

Bir ilanı yeniden okuduğumuzda ya da rafınızda hareket olduğunda seviyeler değişir. Sorgulamak yerine product.out_of_stock olayına abone olun.

Uç noktalar

GET/v1/inventory_levelsStok seviyelerini listele
GET/v1/inventory_levels/{variant}Bir varyantın seviyesini getir

Inventory level nesnesi

variant, product, skustring: Saydıkları.
seller_in_stockboolean: checked_at itibarıyla satıcının onu satıp satamayacağı.
seller_countinteger|null: İlan gösteriyorsa satıcının kendi sayısı.
warehouse_on_handinteger: Rafımızda size ait, kontrol edilmiş ve fotoğraflanmış adetler. Siparişler önce bunlardan gönderilir.
availableinteger: Mağazanızın gösterdiği: talep geldikçe satın aldığımız için rafınız artı satıcının sayısı, en fazla 100. Satıcıda yoksa ve rafınız boşsa ya da ürün duraklatılmışsa 0.
checked_atstring: İlanı en son ne zaman okuduğumuz.

inventory_level

{
  "variant": "var_41hz",
  "product": "prd_8f2k",
  "sku": "5187209554",
  "seller_in_stock": true,
  "seller_count": 812,
  "warehouse_on_hand": 24,
  "available": 124,
  "checked_at": "2026-11-04T09:12:40Z"
}

Stok seviyelerini listele

GET/v1/inventory_levels

Sattığınız tüm varyantlar ya da bir ürününkiler.

Kapsaminventory:read

Sorgu parametreleri

productstring: İsteğe bağlı. Bir ürün id'si.
availablestring: İsteğe bağlı. Mağazanızın tükendi olarak gösterdiği varyantlar için zero.
limit, cursor: Pagination

curl "https://www.ninjabuy.com/api/v1/inventory_levels?product=prd_8f2k" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11"

Response 200

HTTP/2 200 OK

{
  "data": [
    {
      "variant": "var_41hz",
      "product": "prd_8f2k",
      "sku": "5187209554",
      "seller_in_stock": true,
      "seller_count": 812,
      "warehouse_on_hand": 24,
      "available": 124,
      "checked_at": "2026-11-04T09:12:40Z"
    },
    {
      "variant": "var_41j0",
      "product": "prd_8f2k",
      "sku": "5187209555",
      "seller_in_stock": false,
      "seller_count": 0,
      "warehouse_on_hand": 0,
      "available": 0,
      "checked_at": "2026-11-04T09:12:40Z"
    }
  ],
  "has_more": false,
  "cursor": null
}

Bir varyantın seviyesini getir

GET/v1/inventory_levels/{variant}

Son okunduğu hâliyle tek bir varyant. Onu okumak pazaryerini yeniden okumaz.

Kapsaminventory:read

Yol parametreleri

variantstringzorunlu: Bir varyant 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/inventory_levels/var_41hz" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11"

Response 200

HTTP/2 200 OK

{
  "variant": "var_41hz",
  "product": "prd_8f2k",
  "sku": "5187209554",
  "seller_in_stock": true,
  "seller_count": 812,
  "warehouse_on_hand": 24,
  "available": 124,
  "checked_at": "2026-11-04T09:12:40Z"
}