Документация BAZAAR API для внешних интеграций

Query параметры

Пример запроса

curl -X GET "https://bazaar.kg/api/bazaar/v1/products?page=1&pageSize=50" \
  -H "Authorization: Bearer <API_KEY>"

Пример ответа

{
  "store": {
    "id": "store_123",
    "name": "Main Store"
  },
  "currencyCode": "KGS",
  "currencyRateKgsPerUnit": 1,
  "page": 1,
  "pageSize": 50,
  "total": 1,
  "items": [
    {
      "id": "product_123",
      "sku": "COFFEE-250",
      "name": "Coffee 250g",
      "category": "Coffee",
      "categories": ["Coffee", "Beans"],
      "description": "Single-origin whole bean coffee",
      "unit": "pcs",
      "baseUnit": {
        "id": "unit_123",
        "code": "pcs",
        "labelRu": "шт",
        "labelKg": "даана"
      },
      "supplier": {
        "id": "supplier_123",
        "name": "Supplier LLC"
      },
      "isBundle": false,
      "barcodes": ["1234567890123"],
      "packs": [
        {
          "id": "pack_123",
          "packName": "Box",
          "packBarcode": "BOX-123",
          "multiplierToBase": 6,
          "allowInPurchasing": true,
          "allowInReceiving": true
        }
      ],
      "createdAt": "2026-06-01T10:00:00.000Z",
      "updatedAt": "2026-06-04T10:00:00.000Z",
      "price": 900,
      "priceKgs": 900,
      "stockQty": 7,
      "pcs": 7,
      "stockByVariant": [
        {
          "variantKey": "BASE",
          "stockQty": 7,
          "pcs": 7
        }
      ],
      "images": [
        "https://cdn.example.com/products/coffee-main.jpg"
      ],
      "imageObjects": [
        {
          "id": null,
          "url": "https://cdn.example.com/products/coffee-main.jpg",
          "position": 0,
          "isPrimary": true,
          "isAiGenerated": false
        }
      ],
      "variants": [
        {
          "id": "variant_123",
          "sku": "COFFEE-1KG",
          "name": "1 kg",
          "attributes": {
            "size": "1 kg"
          },
          "attributeValues": [
            {
              "key": "size",
              "value": "1 kg"
            }
          ],
          "createdAt": "2026-06-01T10:00:00.000Z",
          "updatedAt": "2026-06-04T10:00:00.000Z",
          "price": 1200,
          "priceKgs": 1200,
          "stockQty": 3,
          "pcs": 3
        }
      ]
    }
  ]
}

Важные поля

Тело запроса

Пример запроса

curl -X POST "https://bazaar.kg/api/bazaar/v1/orders" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "externalId": "MARKET-10001",
  "customerName": "Ivan Ivanov",
  "customerEmail": "ivan@example.com",
  "customerPhone": "+996555111222",
  "customerAddress": "Bishkek, Manas 10",
  "comment": "Delivery after 18:00",
  "lines": [
    {
      "productId": "product_123",
      "qty": 2
    },
    {
      "productId": "product_456",
      "variantId": "variant_456_blue",
      "qty": 1
    }
  ]
}'

Пример ответа

{
  "order": {
    "id": "order_123",
    "number": "SO-000001",
    "status": "CONFIRMED",
    "totalKgs": 3000
  }
}

Тело запроса

Пример запроса

curl -X POST "https://bazaar.kg/api/bazaar/v1/customers" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Ivan Ivanov",
  "email": "ivan@example.com",
  "phone": "+996555111222",
  "address": "Bishkek, Manas 10"
}'

Пример ответа

{
  "action": "created",
  "customer": {
    "id": "customer_123",
    "name": "Ivan Ivanov",
    "email": "ivan@example.com",
    "phone": "+996555111222",
    "address": "Bishkek, Manas 10",
    "source": "INTEGRATION",
    "createdAt": "2026-06-04T10:00:00.000Z",
    "updatedAt": "2026-06-04T10:00:00.000Z"
  }
}