API καταλόγου2026-11Προεπισκόπηση

Παραλλαγές

Μία επιλογή ενός προϊόντος, ένα μέγεθος, ένα χρώμα ή ένα μοντέλο τηλεφώνου, συνδεδεμένη με το SKU του πωλητή που αγοράζουμε και με την παραλλαγή που πουλά το κατάστημά σας.

Η παραλλαγή είναι αυτό που αναφέρει μια γραμμή παραγγελίας. Το επίπεδο αποθέματός της λέει πόσα μπορείτε να πουλήσετε.

Endpoints

GET/v1/products/{id}/variantsΛίστα παραλλαγών προϊόντος
GET/v1/variants/{id}Ανάκτηση παραλλαγής
PATCH/v1/variants/{id}Ενημέρωση παραλλαγής

Το αντικείμενο Variant

idstring: Ξεκινά με var_.
skustring: Το SKU του πωλητή, όπως το διαβάζουμε. Αυτό που αγοράζουμε.
label, options: Οι τιμές των επιλογών, ως μία ετικέτα και ανά όνομα επιλογής.
costmoney: Πόσο χρεώνει ο πωλητής για ένα, σε CN¥, όπως διαβάστηκε τελευταία.
pricemoney: Η τιμή πώλησής σας.
in_stockboolean: Αν μπορεί να το πουλήσει ο πωλητής, όπως διαβάστηκε τελευταία.
unitsinteger: Πόσα αγοράζουμε για κάθε ένα που πουλάτε: ένα πακέτο 3 στο κατάστημά σας αγοράζει 3.
weight_ginteger: Το βάρος συσκευασίας που δώσατε για ένα τεμάχιο, για την εκτίμηση της αποστολής.
external_variant_idstring|null: Η παραλλαγή του καταστήματός σας. Μια παραγγελία της αγοράζει αυτό το SKU· μια παραγγελία για παραλλαγή χωρίς αντιστοίχιση απορρίπτεται.

variant

{
  "id": "var_41hz",
  "product": "prd_8f2k",
  "sku": "5187209554",
  "label": "Black / M",
  "options": { "Color": "Black", "Size": "M" },
  "image": "https://media.ninjabuy.com/listings/weidian-7750970856/sku-black.webp",
  "cost": { "amount": "38.00", "currency": "CNY" },
  "price": { "amount": "49.99", "currency": "USD" },
  "in_stock": true,
  "units": 1,
  "weight_g": 180,
  "external_variant_id": "gid://shopify/ProductVariant/44100231",
  "updated_at": "2026-11-04T09:20:03Z"
}

Λίστα παραλλαγών προϊόντος

GET/v1/products/{id}/variants

Κάθε παραλλαγή με το κόστος, την τιμή σας, το απόθεμα και την αντιστοίχιση.

Scopeproducts:read

Παράμετροι διαδρομής

idstringυποχρεωτικό: Το id του προϊόντος.

Παράμετροι ερωτήματος

limit, cursor: Pagination

Σφάλματα

Κατάσταση	Τύπος	Πότε
404	not-found	Δεν υπάρχει τέτοιο προϊόν σε αυτόν τον λογαριασμό.

curl "https://www.ninjabuy.com/api/v1/products/prd_8f2k/variants" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11"

Response 200

HTTP/2 200 OK

{
  "data": [
    {
      "id": "var_41hz",
      "product": "prd_8f2k",
      "sku": "5187209554",
      "label": "Black / M",
      "options": { "Color": "Black", "Size": "M" },
      "image": "https://media.ninjabuy.com/listings/weidian-7750970856/sku-black.webp",
      "cost": { "amount": "38.00", "currency": "CNY" },
      "price": { "amount": "49.99", "currency": "USD" },
      "in_stock": true,
      "units": 1,
      "weight_g": 180,
      "external_variant_id": "gid://shopify/ProductVariant/44100231",
      "updated_at": "2026-11-04T09:20:03Z"
    },
    {
      "id": "var_41j0",
      "product": "prd_8f2k",
      "sku": "5187209555",
      "label": "Black / L",
      "options": { "Color": "Black", "Size": "M" },
      "image": "https://media.ninjabuy.com/listings/weidian-7750970856/sku-black.webp",
      "cost": { "amount": "38.00", "currency": "CNY" },
      "price": { "amount": "49.99", "currency": "USD" },
      "in_stock": false,
      "units": 1,
      "weight_g": 180,
      "external_variant_id": null,
      "updated_at": "2026-11-04T09:20:03Z"
    }
  ],
  "has_more": false,
  "cursor": null
}

Ανάκτηση παραλλαγής

GET/v1/variants/{id}

Μία παραλλαγή.

Scopeproducts:read

Παράμετροι διαδρομής

idstringυποχρεωτικό: Το id της παραλλαγής.

Σφάλματα

Κατάσταση	Τύπος	Πότε
404	not-found	Δεν υπάρχει τέτοια παραλλαγή σε αυτόν τον λογαριασμό.

curl "https://www.ninjabuy.com/api/v1/variants/var_41hz" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11"

Response 200

HTTP/2 200 OK

{
  "id": "var_41hz",
  "product": "prd_8f2k",
  "sku": "5187209554",
  "label": "Black / M",
  "options": { "Color": "Black", "Size": "M" },
  "image": "https://media.ninjabuy.com/listings/weidian-7750970856/sku-black.webp",
  "cost": { "amount": "38.00", "currency": "CNY" },
  "price": { "amount": "49.99", "currency": "USD" },
  "in_stock": true,
  "units": 1,
  "weight_g": 180,
  "external_variant_id": "gid://shopify/ProductVariant/44100231",
  "updated_at": "2026-11-04T09:20:03Z"
}

Ενημέρωση παραλλαγής

PATCH/v1/variants/{id}

Ορίστε την τιμή της, τα τεμάχια που αγοράζονται ανά πώληση, το βάρος της ή την παραλλαγή καταστήματος στην οποία αντιστοιχεί. Στείλτε μόνο ό,τι αλλάζει.

Scopeproducts:write

Παράμετροι διαδρομής

idstringυποχρεωτικό: Το id της παραλλαγής.

Σώμα

pricemoney: Προαιρετικό. Η τιμή πώλησής σας.
unitsinteger: Προαιρετικό. 1 έως 50.
weight_ginteger: Προαιρετικό. Βάρος ενός τεμαχίου συσκευασμένου, σε γραμμάρια.
external_variant_idstring|null: Προαιρετικό. Αντιστοιχίστε την σε παραλλαγή του καταστήματός σας, ή null για κατάργηση της αντιστοίχισης.

Σφάλματα

Κατάσταση	Τύπος	Πότε
404	not-found	Δεν υπάρχει τέτοια παραλλαγή σε αυτόν τον λογαριασμό.
409	invalid-state	Αυτή η παραλλαγή καταστήματος αντιστοιχεί ήδη σε άλλο SKU.

curl -X PATCH "https://www.ninjabuy.com/api/v1/variants/var_41hz" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11" \
  -H "Content-Type: application/json" \
  -d '{
    "units": 2,
    "price": { "amount": "89.99", "currency": "USD" }
  }'

Response 200

HTTP/2 200 OK

{
  "id": "var_41hz",
  "product": "prd_8f2k",
  "sku": "5187209554",
  "label": "Black / M",
  "options": { "Color": "Black", "Size": "M" },
  "image": "https://media.ninjabuy.com/listings/weidian-7750970856/sku-black.webp",
  "cost": { "amount": "38.00", "currency": "CNY" },
  "price": { "amount": "89.99", "currency": "USD" },
  "in_stock": true,
  "units": 2,
  "weight_g": 180,
  "external_variant_id": "gid://shopify/ProductVariant/44100231",
  "updated_at": "2026-11-04T09:20:03Z"
}