ВБутоне API — Документация

Авторизация

API-ключ передаётся в заголовке X-API-Key или GET-параметром ?api_key=.... Ключ находится в Настройки → API.

Base URL: https://vbutone.ru/api/

curl -H "X-API-Key: YOUR_KEY" \
  https://vbutone.ru/api/shop

$ch = curl_init('https://vbutone.ru/api/shop');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

API_KEY = "YOUR_KEY"
BASE = "https://vbutone.ru/api"
headers = {"X-API-Key": API_KEY}

r = requests.get(f"{BASE}/shop", headers=headers)
data = r.json()

Информация о магазине

GET/api/shop

Название, телефон, адрес, часы работы магазина

Ответ

{
  "success": true,
  "data": {
    "name": "Цветочный Дом",
    "title": "Цветочный Дом — доставка цветов",
    "phone": "+7 (999) 123-45-67",
    "email": "info@example.com",
    "address": "ул. Пушкина, д. 10",
    "work_hours": "Ежедневно 9:00–21:00"
  }
}

Весь каталог

GET/api/catalog

Все товары (цветы + букеты) одним запросом

Параметры

Параметр	Тип	Описание
page	int	Страница (по умолчанию 1)
per_page	int	Кол-во на странице (1–100, по умолчанию 50)
search	string	Поиск по названию

curl -H "X-API-Key: YOUR_KEY" \
  "https://vbutone.ru/api/catalog?page=1&per_page=20"

$ch = curl_init('https://vbutone.ru/api/catalog?page=1&per_page=20');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

foreach ($data['data'] as $item) {
    echo "{$item['type']}: {$item['name']} — {$item['sell_price']} ₽\n";
}

r = requests.get(f"{BASE}/catalog", headers=headers, params={
    "page": 1, "per_page": 20
})
catalog = r.json()

for item in catalog["data"]:
    print(f"{item['type']}: {item['name']} — {item['sell_price']} ₽")

Ответ

{
  "success": true,
  "data": [
    {
      "type": "flower",
      "sku": "FL-001",
      "name": "Роза красная (Эквадор)",
      "color": "красный",
      "sell_price": 350,
      "quantity": 24,
      "photos": ["https://vbutone.ru/uploads/..."]
    },
    {
      "type": "bouquet",
      "sku": "BQ-005",
      "name": "Нежность утра",
      "sell_price": 4500,
      "quantity": 3,
      "composition": [...],
      "photos": ["https://vbutone.ru/uploads/..."]
    }
  ],
  "pagination": { "page": 1, "per_page": 20, "total": 47, "pages": 3 }
}

Цветы

GET/api/flowers

Список цветов с фильтрами

Параметры

Параметр	Тип	Описание
search	string	Поиск по названию/сорту
color	string	Фильтр по цвету (`красный`, `белый`...)
sort	string	Сортировка: `name`, `sell_price`, `color`, `created_at`
dir	string	`asc` или `desc`
page	int	Страница
per_page	int	Кол-во (1–100)

curl -H "X-API-Key: YOUR_KEY" \
  "https://vbutone.ru/api/flowers?color=красный&sort=sell_price&dir=asc"

$params = http_build_query([
    'color' => 'красный',
    'sort'  => 'sell_price',
    'dir'   => 'asc',
]);
$ch = curl_init("https://vbutone.ru/api/flowers?{$params}");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

foreach ($data['data'] as $flower) {
    echo "{$flower['name']} ({$flower['color']}) — {$flower['sell_price']} ₽\n";
    echo "  Фото: " . implode(', ', $flower['photos']) . "\n";
}

r = requests.get(f"{BASE}/flowers", headers=headers, params={
    "color": "красный",
    "sort": "sell_price",
    "dir": "asc"
})
for flower in r.json()["data"]:
    print(f"{flower['name']} ({flower['color']}) — {flower['sell_price']} ₽")
    for photo in flower["photos"]:
        print(f"  {photo}")

Букеты

GET/api/bouquets

Список букетов с составом и фото

Каждый букет включает поле composition — массив цветов с количеством

curl -H "X-API-Key: YOUR_KEY" \
  "https://vbutone.ru/api/bouquets?search=нежность"

$ch = curl_init('https://vbutone.ru/api/bouquets?search=нежность');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

foreach ($data['data'] as $bq) {
    echo "{$bq['name']} — {$bq['sell_price']} ₽\n";
    echo "  Состав:\n";
    foreach ($bq['composition'] as $c) {
        echo "    {$c['name']} ({$c['color']}) x{$c['quantity']}\n";
    }
}

r = requests.get(f"{BASE}/bouquets", headers=headers, params={"search": "нежность"})
for bq in r.json()["data"]:
    print(f"{bq['name']} — {bq['sell_price']} ₽")
    for c in bq["composition"]:
        print(f"  {c['name']} ({c['color']}) x{c['quantity']}")

Товар по артикулу

GET/api/product/{sku}

Детальная информация по SKU (артикул)

curl -H "X-API-Key: YOUR_KEY" \
  https://vbutone.ru/api/product/FL-001

$sku = 'FL-001';
$ch = curl_init("https://vbutone.ru/api/product/{$sku}");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

if ($data['success']) {
    $item = $data['data'];
    echo "{$data['type']}: {$item['name']}\n";
    echo "Цена: {$item['sell_price']} ₽\n";
    echo "В наличии: " . ($item['in_stock'] ? 'да' : 'нет') . "\n";
}

sku = "FL-001"
r = requests.get(f"{BASE}/product/{sku}", headers=headers)
data = r.json()

if data["success"]:
    item = data["data"]
    print(f"{data['type']}: {item['name']}")
    print(f"Цена: {item['sell_price']} ₽")
    print(f"В наличии: {'да' if item['in_stock'] else 'нет'}")

Проверка остатков

POST/api/stock/check

Проверить наличие нескольких товаров перед оформлением

curl -X POST -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"sku":"FL-001","type":"flower"},{"sku":"BQ-005","type":"bouquet"}]}' \
  https://vbutone.ru/api/stock/check

$ch = curl_init('https://vbutone.ru/api/stock/check');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'X-API-Key: YOUR_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'items' => [
            ['sku' => 'FL-001', 'type' => 'flower'],
            ['sku' => 'BQ-005', 'type' => 'bouquet'],
        ]
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

foreach ($data['items'] as $item) {
    $status = $item['in_stock'] ? "✓ {$item['available']} шт." : "✗ нет";
    echo "{$item['sku']}: {$status}\n";
}

r = requests.post(f"{BASE}/stock/check", headers=headers, json={
    "items": [
        {"sku": "FL-001", "type": "flower"},
        {"sku": "BQ-005", "type": "bouquet"},
    ]
})
for item in r.json()["items"]:
    status = f"✓ {item['available']} шт." if item["in_stock"] else "✗ нет"
    print(f"{item['sku']}: {status}")

Ответ

{
  "success": true,
  "items": [
    { "sku": "FL-001", "type": "flower", "name": "Роза красная", "available": 24, "in_stock": true },
    { "sku": "BQ-005", "type": "bouquet", "name": "Нежность утра", "available": 3, "in_stock": true }
  ]
}

Оформление заказа

POST/api/order

Создать заказ. Остатки списываются автоматически (в транзакции).

Если товара нет в наличии, заказ вернёт ошибку 422 со списком проблем

Тело запроса

Поле	Тип	Описание
name *	string	Имя покупателя
phone *	string	Телефон
address *	string	Адрес доставки
email	string	Email
delivery_time	string	Желаемое время доставки
comment	string	Комментарий
items *	array	Массив: `[{"sku","type","qty"}]`

curl -X POST -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Иван Петров",
    "phone": "+7 (999) 123-45-67",
    "address": "ул. Пушкина, д. 10, кв. 5",
    "email": "ivan@example.com",
    "delivery_time": "завтра к 14:00",
    "items": [
      {"sku": "FL-001", "type": "flower", "qty": 5},
      {"sku": "BQ-005", "type": "bouquet", "qty": 1}
    ]
  }' \
  https://vbutone.ru/api/order

$ch = curl_init('https://vbutone.ru/api/order');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'X-API-Key: YOUR_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'name'          => 'Иван Петров',
        'phone'         => '+7 (999) 123-45-67',
        'address'       => 'ул. Пушкина, д. 10, кв. 5',
        'email'         => 'ivan@example.com',
        'delivery_time' => 'завтра к 14:00',
        'items' => [
            ['sku' => 'FL-001', 'type' => 'flower', 'qty' => 5],
            ['sku' => 'BQ-005', 'type' => 'bouquet', 'qty' => 1],
        ],
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

if ($data['success']) {
    echo "Заказ #{$data['order_id']} — {$data['total']} ₽\n";
} else {
    echo "Ошибка: " . ($data['error'] ?? implode(', ', $data['errors'] ?? [])) . "\n";
}

r = requests.post(f"{BASE}/order", headers=headers, json={
    "name": "Иван Петров",
    "phone": "+7 (999) 123-45-67",
    "address": "ул. Пушкина, д. 10, кв. 5",
    "email": "ivan@example.com",
    "delivery_time": "завтра к 14:00",
    "items": [
        {"sku": "FL-001", "type": "flower", "qty": 5},
        {"sku": "BQ-005", "type": "bouquet", "qty": 1},
    ]
})
data = r.json()

if data["success"]:
    print(f"Заказ #{data['order_id']} — {data['total']} ₽")
else:
    print(f"Ошибка: {data.get('error', data.get('errors'))}")

Успешный ответ

{
  "success": true,
  "order_id": 42,
  "total": 6250,
  "message": "Order placed successfully"
}

Ошибка остатков (422)

{
  "success": false,
  "errors": [
    "'Роза красная' — only 3 available"
  ]
}