Catalog API2026-11إصدار تجريبي

مستويات المخزون

كم يمكنك أن تبيع من متغيّر الآن: مخزون البائع في الصين، إضافة إلى ما تحفظه في مستودعنا.

تتغيّر المستويات حين نقرأ صفحة منتج مجددًا أو يتغيّر رفّك. اشترك في product.out_of_stock بدل الاستعلام المتكرر.

نقاط النهاية

GET/v1/inventory_levelsعرض مستويات المخزون
GET/v1/inventory_levels/{variant}جلب مستوى مخزون متغيّر

كائن 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: اختياري. معرّف منتج.
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مطلوب: معرّف متغيّر.

الأخطاء

الحالة	النوع	متى
404	not-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"
}