К основному содержимому

Обновление Публичного API: упрощённая аутентификация и новые эндпоинты для заказов и расчетов

Узнайте больше о последних обновлениях RemOnline

Hanna avatar
Автор: Hanna
Обновлено на этой неделе

Познакомьтесь с последними улучшениями Публичного 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

Эти обновления закладывают основу для интеграции с интернет-магазинами и маркетплейсами, где заказы, импортированные из магазинов, будут включать полный список позиций. Мы уже работаем над прямыми интеграциями с Prom (Украина) и Shopify. А пока вы можете самостоятельно настраивать интеграции с интернет-магазинами при наличии доступа к их API.

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

Во всех новых эндпоинтах используется формат даты ISO 8601, например:

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

Гибкая пагинация с параметром pageSize

Эндпоинты с пагинацией (GET /orders, GET /estimates) теперь поддерживают параметр pageSize:

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

  • По умолчанию: pageSize=50

Уменьшайте значение для более быстрых ответов или увеличивайте, чтобы получить больше данных за один запрос.

Поделитесь своими впечатлениями об этих обновлениях API. Если у вас есть отзывы или предложения — напишите нашей Службе поддержки в чате.

Нашли ответ на свой вопрос?