API Catalogo2026-11Anteprima
Livelli di stock
Quanti pezzi di una variante puoi vendere ora: lo stock del venditore in Cina, più ciò che tieni nel nostro magazzino.
I livelli cambiano quando rileggiamo un’inserzione o il tuo scaffale si muove. Iscriviti a product.out_of_stock invece di interrogare l’API.
L’oggetto Inventory level
variant, product, skustring- Cosa conta.
seller_in_stockboolean- Se il venditore può venderlo, alla data di checked_at.
seller_countinteger|null- Il conteggio del venditore, quando l’inserzione ne mostra uno.
warehouse_on_handinteger- Unità tue sul nostro scaffale, controllate e fotografate. Gli ordini partono prima da queste.
availableinteger- Ciò che mostra il tuo negozio: il tuo scaffale più il conteggio del venditore, con un tetto di 100, visto che acquistiamo su richiesta. 0 quando il venditore è senza stock e il tuo scaffale è vuoto, o il prodotto è in pausa.
checked_atstring- Quando abbiamo letto l’ultima volta l’inserzione.
{
"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"
}Elenca i livelli di stock
GET/v1/inventory_levels
Tutte le varianti che vendi, o quelle di un prodotto.
Scopeinventory:read
Parametri di query
productstring- Facoltativo. Un ID prodotto.
availablestring- Facoltativo. zero per le varianti che il tuo negozio mostra come esaurite.
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"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
}Recupera il livello di una variante
GET/v1/inventory_levels/{variant}
Una variante, come letta l’ultima volta. Leggerla non rilegge il marketplace.
Scopeinventory:read
Parametri di percorso
variantstringobbligatorio- Un ID di variante.
Errori
| Stato | Tipo | Quando |
|---|---|---|
| 404 | not-found | Nessuna variante simile su questo account. |
curl "https://www.ninjabuy.com/api/v1/inventory_levels/var_41hz" \
-H "Authorization: Bearer $NINJABUY_API_KEY" \
-H "NinjaBuy-Version: 2026-11"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"
}