Зміни в роботі API RemOnline
У недавньому оновленні RemOnline були внесені зміни в роботу API. У цій статті розповідаємо про них.
Отримання залишку товарів на складі
Тепер ви можете відфільтрувати товари з нульовим залишком за допомогою аргументу exclude_zero_residue=True
Приклад:
curl -G https://api.remonline.ua/warehouse/goods/1 \ -d "token=7bab555b5ed075353de2263dd50a394c84a4625a" -d "exclude_zero_residue=True"
API RemOnline поверне список тільки тих товарів, залишок яких більше нуля:
{
"count": 1,
"data": [
{
"id": 1,
"title": "Product Title",
"image": "https://storage.remonline.ru/path/image.png",
"code": "",
"price": {
"1": 799,
"2": 999
},
"article": "A123",
"residue": 8,
"description": "Product Description",
"category": {
"id": 2,
"title": "Product Category",
"parent_id": 1
}
}
],
"page": 1,
"success": true
}
Напрямок сортування транзакцій по касі
Передайте атрибут sort_dir в метод https://api.remonline.ua/cashbox/report/<cashbox_id>, щоб задати напрямок сортування.
Приклад:
curl -G https://api.remonline.ua/cashbox/report/6 \ -d "token=7bab555b5ed075353de2263dd50a394c84a4625a" -d "sort_dir=desc"
Результат:
API RemOnline поверне список транзакцій, відсортований в зворотному порядку.
Напрямок сортування Замовлень
Передайте атрибут sort_dir в метод https://api.remonline.ua/order/, щоб задати напрямок сортування.
Приклад:
curl -G https://api.remonline.ua/order/ \ -d "token=7bab555b5ed075353de2263dd50a394c84a4625a" -d "sort_dir=desc"
Результат:
API RemOnline поверне список замовлень, відсортований в зворотному порядку.
Нові методи роботи з довідниками
У недавньому оновленні в RemOnline з'явилася можливість створювати користувацькі довідники. У зв'язку з цим ми додали в API нові методи для роботи з цими довідниками.
Для отримання списку довідників використовуйте метод https://api.remonline.ua/book/list/
Приклад:
curl -G https://api.remonline.ua/book/list/ \ -d "token=7bab555b5ed075353de2263dd50a394c84a4625a"
Відповідь:
{
"data": [
{
"id": 1,
"title": "Моделі"
},
{
"id": 2,
"title": "Несправності"
}
],
"page": 1,
"count": 2,
"success": true
}
Щоб отримати список значень потрібного вам довідника, використовуйте метод https://api.remonline.ua/book-item/list/<book_id>
Приклад:
url -G https://api.remonline.ua/book-item/list/1 \ -d "token=7bab555b5ed075353de2263dd50a394c84a4625a"
Відповідь:
{
"data": [
{
"id": 1933222,
"title": "Висне на заставці"
},
{
"id": 1933224,
"title": "Вимикаєтсья"
},
{
"id": 1933226,
"title": "Не вмикається"
}
],
"page": 1,
"count": 3,
"success": true
}
Зверніть увагу: метод API для отримання списку моделей https://api.remonline.ua/books/models/<branch_id> вважається застарілим і буде підтримуватись до 1 травня 2019 року. Після цієї дати підтримка методу буде припинена.
Наостанок залишаємо посилання на повну документацію API RemOnline, де ви знайдете докладний опис кожного методу з прикладами використання.