Kontentga o'tish
Dasturchilar uchun BILLZ

Get Products

GET
/v2/products
curl --request GET \
  --url 'https://api-admin.billz.ai/v2/products?page=1&limit=5&search=Nike&include_empty_stocks=false' \
  --header 'Authorization: Bearer <token>' \
  --header 'platform-id: 7d4a4c38-dd84-4902-b744-0488b80a4c01'

Xato kodlari: 400 — kiruvchi ma’lumotlar validatsiya xatosi; 404 — obyekt topilmadi; 401, 403, 429, 500 — barcha metodlar uchun umumiy. Tana formatlari va semantikasi: Javob kodlari va xatolar.

Authorizations

“Authorizations” bo'limi

Parameters

“Parameters” bo'limi

Query Parameters

“Query Parameters” bo'limi
page
integer format: int32
default: 1

Sahifa raqami; raqam bo’lmagan qiymat — 400

limit
integer format: int32
default: 100

Bir sahifadagi soni. Raqam bo’lmagan qiymat -> 400

Example
5
search
string

Qidiruv satri. Uzunligi cheklangan; takrorlanuvchi patternlar rad etiladi

Example
Nike
fields
Array<string>

Qidiruv maydonlari: name, sku, barcode, description, category, brand yoki custom_field_id. Vergul bilan ajratilgan satr sifatida uzatiladi

last_updated_date
string

Format yyyy-mm-dd hh:mm:ss, UTC. Noto’g’ri format — 400

include_empty_stocks
boolean

true satri

Header Parameters

“Header Parameters” bo'limi
platform-id
string
default: 7d4a4c38-dd84-4902-b744-0488b80a4c01

Platforma identifikatori. Integratsiyalar uchun statik qiymat ishlatiladi.

Responses

“Responses” bo'limi

200

“200” bo'limi

Muvaffaqiyatli javob

Media typeapplication/json
object
count

Mahsulotlar soni

integer format: int32
products

Tovarlar ro’yxati

Array<object>
nullable
object
id

Mahsulot id si

string
parent_id

Ota id si (variatsiyalar uchun)

string
categories

Mahsulot kategoriyalari

Array<object>
object
id
string
name
string
parent_id
string
brand_id

Brend id si

string
brand_name

Brend nomi

string
is_variative

Mahsulot variatsiyalimi

boolean
name

Nomi

string
sku

Artikul

string
main_image_url

Asosiy fotosurat

string
main_image_url_full
string
barcode

Shtrix-kod

string
description

Tavsif

string
updated_at

Oxirgi yangilanish sanasi

string
measurement_unit

O’lchov birligi

object
id
string
name
string
short_name
string
product_type_id

Mahsulot turi id si

string
shop_measurement_values

Savdo nuqtalari bo’yicha qoldiqlar

Array<object>
object
shop_id
string
shop_name
string
active_measurement_value
number format: double
shop_prices

Savdo nuqtalari bo’yicha narxlar

Array<object>
object
shop_id
string
shop_name
string
retail_price
number format: double
retail_currency
string
supply_price
number format: double
supply_currency
string
promo_price
number format: double
promos

Aksiyalar

Array<object>
nullable
object
id
string
external_id
string
name
string
discount_value
number format: double
discount_type
string
shop_ids
Array<string>
product_attributes

Variatsiya atributlari

Array<object>
object
attribute_id
string
attribute_value_id
string
attribute_value
string
attribute_name
string
custom_fields

Maxsus xususiyatlar

Array<object>
nullable
object
custom_field_name
string
custom_field_system_name
string
custom_field_id
string
custom_field_value
string
from_parent
boolean
is_marked
boolean
photos

Fotosuratlar

Array<object>
object
photo_url
string
sequence
integer format: int32
is_main
boolean
supply_price

Kelish narxi

number format: double
supply_currency

Xarid valyutasi

string
suppliers

Yetkazib beruvchilar

Array<object>
object
id
string
company_id
string
name
string
session_id
string
deleted_at
integer format: int64
product_supplier_stock

Yetkazib beruvchilar bo’yicha qoldiqlar

Array<object>
nullable
object
supplier_id
string
supplier_name
string
shop_id
string
measurement_value
number format: double
min_supply_price
number format: double
max_supply_price
number format: double
retail_price
number format: double
wholesale_price
number format: double
Examplegenerated
{
  "count": 1,
  "products": [
    {
      "id": "example",
      "parent_id": "example",
      "categories": [
        {
          "id": "example",
          "name": "example",
          "parent_id": "example"
        }
      ],
      "brand_id": "example",
      "brand_name": "example",
      "is_variative": true,
      "name": "example",
      "sku": "example",
      "main_image_url": "example",
      "main_image_url_full": "example",
      "barcode": "example",
      "description": "example",
      "updated_at": "example",
      "measurement_unit": {
        "id": "example",
        "name": "example",
        "short_name": "example"
      },
      "product_type_id": "example",
      "shop_measurement_values": [
        {
          "shop_id": "example",
          "shop_name": "example",
          "active_measurement_value": 1
        }
      ],
      "shop_prices": [
        {
          "shop_id": "example",
          "shop_name": "example",
          "retail_price": 1,
          "retail_currency": "example",
          "supply_price": 1,
          "supply_currency": "example",
          "promo_price": 1,
          "promos": [
            {
              "id": "example",
              "external_id": "example",
              "name": "example",
              "discount_value": 1,
              "discount_type": "example",
              "shop_ids": [
                "example"
              ]
            }
          ]
        }
      ],
      "product_attributes": [
        {
          "attribute_id": "example",
          "attribute_value_id": "example",
          "attribute_value": "example",
          "attribute_name": "example"
        }
      ],
      "custom_fields": [
        {
          "custom_field_name": "example",
          "custom_field_system_name": "example",
          "custom_field_id": "example",
          "custom_field_value": "example",
          "from_parent": true
        }
      ],
      "is_marked": true,
      "photos": [
        {
          "photo_url": "example",
          "sequence": 1,
          "is_main": true
        }
      ],
      "supply_price": 1,
      "supply_currency": "example",
      "suppliers": [
        {
          "id": "example",
          "company_id": "example",
          "name": "example",
          "session_id": "example",
          "deleted_at": 1
        }
      ],
      "product_supplier_stock": [
        {
          "supplier_id": "example",
          "supplier_name": "example",
          "shop_id": "example",
          "measurement_value": 1,
          "min_supply_price": 1,
          "max_supply_price": 1,
          "retail_price": 1,
          "wholesale_price": 1
        }
      ]
    }
  ]
}