2. Первый запрос
Получить токен доступа
Заголовок раздела «Получить токен доступа»curl -X POST 'https://api-admin.billz.ai/v1/auth/login' \ -H 'Content-Type: application/json' \ -d '{"secret_token": "СЕКРЕТНЫЙ_КЛЮЧ"}'Ответ:
{ "code": 200, "message": "ok", "error": null, "data": { "access_token": "eyJhbGciOi...", "refresh_token": "eyJhbGciOi...", "token_type": "Bearer", "expires_in": 1296000 }}expires_in — секунды: у входа по ключу это 15 суток. Вместе с ним сохраняется
refresh_token (срок жизни — 30 суток): им обновляют пару токенов без обращения
к секретному ключу.

Прочитать каталог
Заголовок раздела «Прочитать каталог»curl -X GET 'https://api-admin.billz.ai/v2/products?limit=5&search=Nike' \ -H 'Authorization: Bearer ACCESS_TOKEN'Ответ — объект с двумя полями:
{ "count": 134, "products": [ { "id": "00000000-0000-0000-0000-000000000000", "name": "Air Jordan 1 High", "barcode": "978020137962", "sku": "THY-1232", "shop_measurement_values": [ { "shop_id": "...", "shop_name": "Nike Store", "active_measurement_value": 5 } ], "shop_prices": [ { "shop_id": "...", "shop_name": "Nike Store", "retail_price": 1000000, "retail_currency": "UZS", "supply_price": 600000, "supply_currency": "UZS", "promo_price": 0, "promos": [] } ] } ]}Остатки и цены приходят в разрезе магазинов.
Полезные параметры
Заголовок раздела «Полезные параметры»| Параметр | Смысл |
|---|---|
limit, page |
пагинация; по умолчанию 100 записей на страницу |
search |
строка поиска; подстрока, регистр не важен. По умолчанию ищет по названию, SKU, штрихкоду и описанию |
Остальные параметры каталога — фильтры по датам, магазинам и полям поиска — разобраны в синхронизации каталога.
Дальше: первая продажа.