API katalogu2026-11Podgląd

Warianty

Jedna opcja produktu — rozmiar, kolor lub model telefonu — powiązana z SKU sprzedawcy, który kupujemy, i z wariantem, który sprzedaje twój sklep.

Wariant to to, co wskazuje pozycja zamówienia. Jego stan magazynowy mówi, ile możesz sprzedać.

Endpointy

GET/v1/products/{id}/variantsLista wariantów produktu
GET/v1/variants/{id}Pobranie wariantu
PATCH/v1/variants/{id}Aktualizacja wariantu

Obiekt Variant

idstring: Zaczyna się od var_.
skustring: SKU sprzedawcy w naszym odczycie. To, co kupujemy.
label, options: Wartości opcji, jako jedna etykieta i według nazwy opcji.
costmoney: Ile sprzedawca bierze za jedną sztukę, w CN¥, według ostatniego odczytu.
pricemoney: Twoja cena sprzedaży.
in_stockboolean: Czy sprzedawca może to sprzedać, według ostatniego odczytu.
unitsinteger: Ile kupujemy na każdą sprzedaną przez ciebie: zestaw 3 szt. w twoim sklepie kupuje 3.
weight_ginteger: Podana przez ciebie waga jednej sztuki z opakowaniem, używana do szacowania wysyłki.
external_variant_idstring|null: Wariant twojego sklepu. Zamówienie na niego kupuje ten SKU; zamówienie na niezmapowany wariant jest odrzucane.

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"
}

Lista wariantów produktu

GET/v1/products/{id}/variants

Każdy wariant z kosztem, twoją ceną, stanem i mapowaniem.

Zakresproducts:read

Parametry ścieżki

idstringwymagane: ID produktu.

Parametry zapytania

limit, cursor: Pagination

Błędy

Status	Typ	Kiedy
404	not-found	Na tym koncie nie ma takiego produktu.

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
}

Pobranie wariantu

GET/v1/variants/{id}

Jeden wariant.

Zakresproducts:read

Parametry ścieżki

idstringwymagane: ID wariantu.

Błędy

Status	Typ	Kiedy
404	not-found	Na tym koncie nie ma takiego wariantu.

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"
}

Aktualizacja wariantu

PATCH/v1/variants/{id}

Ustaw jego cenę, liczbę sztuk kupowanych na sprzedaż, wagę lub wariant sklepu, któremu odpowiada. Wysyłaj tylko to, co się zmienia.

Zakresproducts:write

Parametry ścieżki

idstringwymagane: ID wariantu.

Body

pricemoney: Opcjonalne. Twoja cena sprzedaży.
unitsinteger: Opcjonalne. Od 1 do 50.
weight_ginteger: Opcjonalne. Waga jednej sztuki z opakowaniem, w gramach.
external_variant_idstring|null: Opcjonalne. Zmapuj na wariant w swoim sklepie albo null, aby usunąć mapowanie.

Błędy

Status	Typ	Kiedy
404	not-found	Na tym koncie nie ma takiego wariantu.
409	invalid-state	Ten wariant sklepu odpowiada już innemu 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"
}