Перейти к содержимому

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 суток): им обновляют пару токенов без обращения к секретному ключу.

Выпуск токена: приложение отправляет секретный ключ в POST /v1/auth/login, API возвращает access_token, refresh_token и expires_in, приложение сохраняет пару

Окно терминала
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, штрихкоду и описанию

Остальные параметры каталога — фильтры по датам, магазинам и полям поиска — разобраны в синхронизации каталога.

Дальше: первая продажа.