Ninjabuy 로고Business
영업팀에 문의
카탈로그 API2026-11프리뷰

재고 수준

지금 판매할 수 있는 옵션 수량: 중국 판매자의 재고와 저희 창고에 보관 중인 내 재고의 합.

재고 수준은 저희가 상품을 다시 읽거나 선반이 바뀔 때 변해요. 폴링 대신 product.out_of_stock을 구독하세요.

엔드포인트

Inventory level 객체

variant, product, skustring
세는 것.
seller_in_stockboolean
판매자가 판매할 수 있는지(checked_at 기준).
seller_countinteger|null
상품 페이지에 표시된 경우 판매자 자체 수량.
warehouse_on_handinteger
저희 선반에 있는 검수·촬영된 내 재고. 주문은 먼저 여기서 배송돼요.
availableinteger
스토어에 표시되는 수량: 내 선반과 판매자 수량의 합이며, 주문 시 구매하므로 최대 100. 판매자가 품절이고 선반도 비었거나 상품이 일시 중지되면 0.
checked_atstring
상품을 마지막으로 읽은 시각.
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"
}

재고 수준 목록

GET/v1/inventory_levels

판매 중인 모든 옵션 또는 상품 하나의 옵션.

범위inventory:read

쿼리 매개변수

productstring
선택 사항. 상품 ID.
availablestring
선택 사항. 스토어에서 품절로 표시하는 옵션은 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
}

옵션의 재고 수준 조회

GET/v1/inventory_levels/{variant}

마지막으로 읽은 옵션 하나. 이것을 읽어도 마켓플레이스를 다시 읽지 않아요.

범위inventory:read

경로 매개변수

variantstring필수
옵션 ID.

오류

상태유형시점
404not-found이 계정에 해당 옵션이 없어요.
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"
}