Перейти до основного контенту

Оновлення Публічного API: спрощена автентифікація та нові ендпоінти для замовлень і кошторисів

Дізнайтеся більше про останні оновлення RemOnline

Hanna avatar
Автор: Hanna
Оновлено цього тижня

Ознайомтеся з останніми покращеннями Public API RemOnline, які допоможуть вам створювати інтеграції та автоматизації зі сторонніми сервісами.

Спрощена автентифікація через Bearer Token

Тепер ви можете автентифікувати запити, використовуючи стандартну Bearer-автентифікацію:

Authorization: Bearer YOUR_API_KEY

Це стандартна автентифікація Bearer, яка спрощує та пришвидшує інтеграцію.

Важливо: Стара методика автентифікації (POST /token/new) є застарілою та буде відключена 1 вересня 2025 року. Перейдіть на новий метод заздалегідь, щоб уникнути перебоїв у роботі.

Нові ендпоінти для замовлень і кошторисів

Ми оновили структуру API та додали нові ендпоінти для роботи з замовленнями та кошторисами, зробивши їх більш гнучкими та відповідними стандарту REST.

Старі методи вважаються застарілими і будуть доступні лише до 1 вересня 2025 року.

Для оновлення використовуваних методів скористайтеся документацією.

Списки позицій як окремий ресурс

Товари та послуги в замовленнях і кошторисах тепер обробляються як окремий ресурс — items:

  • GET /orders/{id} — загальна інформація про замовлення

  • GET /orders/{id}/items — список позицій

Також доступні ендпоінти для роботи з табличною частиною замовлень і кошторисів

  • POST /orders/{id}/items — додавання позиції (товари додаються без списання зі складу)

  • PATCH /orders/{id}/items/{item_id} — оновлення даних позиції

Аналогічна структура доступна для розрахунків: /estimates/{id}/items

Ці оновлення є основою для інтеграції з інтернет-магазинами та маркетплейсами, де ви зможете передавати замовлення з магазинів у RemOnline включно з переліком доданих позицій. Ми вже працюємо над прямими інтеграціями з Prom та Shopify. Ви тим часом також можете налаштувати інтеграції з інтернет-магазинами, якщо маєте доступ до API.

Новий формат дати ISO 8601

У всіх нових ендпоінтах використовується формат дати ISO 8601, наприклад:

"createdAt": "2025-05-14T08:35:05Z"

Гнучка пагінація з параметром pageSize

Ендпоінти з пагінацією (GET /orders, GET /estimates) тепер підтримують параметр pageSize:

  • Допустимі значення: від 10 до 100

  • За замовчуванням: pageSize=50

Зменшуйте значення для швидших відповідей або збільшуйте, щоб отримати більше даних за один запит.

Поділіться з нами своїми враженнями стосовно цих оновлень. Якщо у вас є відгуки або пропозиції — напишіть до нашої Служби підтримки в чаті.

Ви отримали відповідь на своє запитання?