API товаров

Подключите свой магазин к biznesebi.ge. Есть два пути - выберите удобный.

1. Фид (рекомендуем)

Вы даёте ссылку на каталог, мы сами читаем её раз в сутки. Код писать не нужно - WooCommerce, OpenCart, Shopify и Magento уже создают такой файл.

2. REST API

Если у вас есть разработчик и товары должны обновляться мгновенно - используйте API. Та же логика, только отправляете вы.

Аутентификация

Ключ создаётся в панели. Передавайте его в одном из заголовков:

Базовый адрес

https://biznesebi.ge/api/v1

Authorization: Bearer bzn_live_xxxxxxxxxxxx_yyyy
# ან
X-API-Key: bzn_live_xxxxxxxxxxxx_yyyy

Идемпотентность

external_id - это ваш собственный идентификатор товара. Повторная отправка с тем же external_id обновит ту же запись, а не создаст дубликат. Поэтому повтор после таймаута безопасен.

Методы

GET/meანგარიშის და ლიმიტების მდგომარეობა

GET/categoriesკატეგორიების სია (?q= ძებნით)

GET/citiesქალაქების სია

GET/productsთქვენი პროდუქცია (cursor-პაგინაცია)

POST/productsპროდუქციის დამატება/განახლება (batch)

GET/products/{external_id}ერთი პროდუქტი

PATCH/products/{external_id}ფასი / მარაგი

DELETE/products/{external_id}არქივში გადატანა

POST /products

curl -X POST https://biznesebi.ge/api/v1/products \
  -H "Authorization: Bearer bzn_live_xxxxxxxxxxxx_yyyy" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [
      {
        "external_id": "SKU-1043",
        "title": "ოფისის სავარძელი Ergo Pro",
        "description": "ერგონომიული სავარძელი წელის საყრდენით.",
        "price": 749.00,
        "currency": "GEL",
        "availability": "IN_STOCK",
        "sku": "ERG-PRO-BLK",
        "brand": "Ergo",
        "product_url": "https://shop.ge/p/1043",
        "images": ["https://shop.ge/img/1043.jpg"],
        "specifications": [
          { "key": "მასალა", "value": "ბადე + ალუმინი" },
          { "key": "წონის ლიმიტი", "value": "130 კგ" }
        ]
      }
    ]
  }'

200 / 201 / 207

{
  "summary": { "created": 1, "updated": 0, "unchanged": 0, "skipped": 0, "failed": 0 },
  "quota": { "limit": 1000, "used": 431, "remaining": 569 },
  "results": [
    { "external_id": "SKU-1043", "status": "created", "id": "cm4x9..." }
  ]
}

PATCH /products/{external_id}

curl -X PATCH https://biznesebi.ge/api/v1/products/SKU-1043 \
  -H "Authorization: Bearer bzn_live_xxxxxxxxxxxx_yyyy" \
  -H "Content-Type: application/json" \
  -d '{ "price": 699.00, "availability": "IN_STOCK" }'

Поля товара

ველი	ტიპი	Описание
`external_id`обязательно	`string`	თქვენი საკუთარი ID - იდემპოტენტურობის გასაღები
`title`обязательно	`string`	2-200 სიმბოლო
`description`	`string`	მაქს. 5000; თუ არ მიუთითებთ, გამოიყენება title
`type`	`PRODUCT \| SERVICE`	ნაგულისხმევი PRODUCT
`price`	`number \| null`	0 ან null = შეთანხმებით
`price_max`	`number \| null`	თუ price-ზე მეტია, გამოჩნდება დიაპაზონი
`currency`	`GEL \| USD \| EUR`	ნაგულისხმევი GEL
`availability`	`IN_STOCK \| OUT_OF_STOCK \| MADE_TO_ORDER`	მარაგის სტატუსი
`category_id`	`string`	GET /categories-იდან; არასავალდებულო
`city_id`	`string`	GET /cities-იდან; არასავალდებულო
`sku`	`string`	არტიკული / MPN
`brand`	`string`	ავტომატურად ემატება მახასიათებლებში
`min_order_qty`	`integer`	მინიმალური შეკვეთა
`price_unit`	`string`	ცალი, კგ, მ2...
`delivery_info`	`string`	მიწოდების პირობები
`product_url`	`url`	ბმული თქვენს გვერდზე
`images`	`url[]`	მაქს. 20; ჩვენს CDN-ზე გადმოვიტანთ
`specifications`	`{key, value}[]`	მაქს. 50
`publish`	`boolean`	ნაგულისხმევი true

Ошибки

Все ошибки одной формы. Опирайтесь на код, а не на текст - текст может измениться.

{
  "error": {
    "code": "batch_too_large",
    "message": "This plan allows 100 products per request; 250 were sent."
  },
  "requestId": "0f2c1a64-..."
}

Лимиты

Лимиты зависят от тарифа. Текущее состояние всегда видно в GET /api/v1/me.

Важно знать

Фотографии мы копируем на свой CDN, а не ссылаемся на ваш сервер. Это защищает приватность посетителей, и фото не пропадут, если у вас изменятся адреса.
DELETE не удаляет - переводит в архив. Ссылка, статистика и запросы сохраняются.
Объявление, созданное вручную в панели, API перезаписать не может. Так задумано.
category_id необязателен. Без него товар попадёт в категорию вашего бизнеса.

Вопросы

Свяжитесь с нами - поможем с интеграцией.