API katalogu2026-11Podgląd

Stany magazynowe

Ile sztuk wariantu możesz sprzedać teraz: stan sprzedawcy w Chinach plus to, co trzymasz w naszym magazynie.

Stany zmieniają się, gdy ponownie odczytujemy ofertę albo zmienia się twoja półka. Subskrybuj product.out_of_stock zamiast odpytywać.

Endpointy

GET/v1/inventory_levelsLista stanów magazynowych
GET/v1/inventory_levels/{variant}Pobranie stanu wariantu

Obiekt Inventory level

variant, product, skustring: Co liczy.
seller_in_stockboolean: Czy sprzedawca może to sprzedać, na moment checked_at.
seller_countinteger|null: Liczba podana przez sprzedawcę, jeśli oferta ją pokazuje.
warehouse_on_handinteger: Twoje sztuki na naszej półce, sprawdzone i sfotografowane. Zamówienia wychodzą najpierw z nich.
availableinteger: Co pokazuje twój sklep: twoja półka plus liczba u sprzedawcy, maksymalnie 100, bo kupujemy na żądanie. 0, gdy sprzedawca nie ma towaru, a twoja półka jest pusta, albo produkt jest wstrzymany.
checked_atstring: Kiedy ostatnio odczytaliśmy ofertę.

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

Lista stanów magazynowych

GET/v1/inventory_levels

Każdy sprzedawany wariant lub warianty jednego produktu.

Zakresinventory:read

Parametry zapytania

productstring: Opcjonalne. ID produktu.
availablestring: Opcjonalne. zero dla wariantów, które twój sklep pokazuje jako wyprzedane.
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
}

Pobranie stanu wariantu

GET/v1/inventory_levels/{variant}

Jeden wariant według ostatniego odczytu. Jego odczytanie nie odpytuje ponownie marketplace’u.

Zakresinventory:read

Parametry ścieżki

variantstringwymagane: ID wariantu.

Błędy

Status	Typ	Kiedy
404	not-found	Na tym koncie nie ma takiego wariantu.

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