API καταλόγου2026-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- Πότε διαβάσαμε τελευταία την καταχώριση.
{
"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
Κάθε παραλλαγή που πουλάτε, ή ενός προϊόντος.
Scopeinventory: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"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}
Μία παραλλαγή, όπως διαβάστηκε τελευταία. Η ανάγνωσή της δεν διαβάζει ξανά την πλατφόρμα.
Scopeinventory:read
Παράμετροι διαδρομής
variantstringυποχρεωτικό- Ένα id παραλλαγής.
Σφάλματα
| Κατάσταση | Τύπος | Πότε |
|---|---|---|
| 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"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"
}