Logo NinjabuyBusiness
Contacter l'équipe commerciale
API Catalogue2026-11Aperçu

Niveaux de stock

Combien d’unités d’une variante vous pouvez vendre maintenant : le stock du vendeur en Chine, plus ce que vous gardez dans notre entrepôt.

Les niveaux changent quand nous relisons une annonce ou que votre étagère bouge. Abonnez-vous à product.out_of_stock plutôt que d’interroger l’API.

Endpoints

L’objet Inventory level

variant, product, skustring
Ce qu’il compte.
seller_in_stockboolean
Si le vendeur peut le vendre, à la date de checked_at.
seller_countinteger|null
Le décompte du vendeur, quand l’annonce en affiche un.
warehouse_on_handinteger
Les unités qui vous appartiennent sur notre étagère, vérifiées et photographiées. Les commandes partent d’abord de celles-ci.
availableinteger
Ce qu’affiche votre boutique : votre étagère plus le stock du vendeur, plafonné à 100, puisque nous achetons à la demande. 0 quand le vendeur est en rupture et votre étagère vide, ou que le produit est en pause.
checked_atstring
La dernière lecture de l’annonce.
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"
}

Lister les niveaux de stock

GET/v1/inventory_levels

Toutes les variantes que vous vendez, ou celles d’un produit.

Scopeinventory:read

Paramètres de requête

productstring
Facultatif. Un identifiant de produit.
availablestring
Facultatif. zero pour les variantes que votre boutique affiche comme épuisées.
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
}

Récupérer le niveau d’une variante

GET/v1/inventory_levels/{variant}

Une variante, telle que lue la dernière fois. La lire ne relit pas la marketplace.

Scopeinventory:read

Paramètres de chemin

variantstringobligatoire
Un identifiant de variante.

Erreurs

StatutTypeQuand
404not-foundAucune variante de ce type sur ce compte.
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"
}