Рефсейлс API

Изменения API

Что добавилось и изменилось в API v1.

Изменения обратно совместимы, если не сказано иначе. Новые поля в ответах появляются без предупреждения: не падайте на незнакомых ключах.

27 сентября 2026

Вебхуки. События order.created, order.status_changed и order.payment_status_changed приходят на ваш сервер POST-запросом с подписью HMAC-SHA256. Подключаются в настройках магазина. Подробнее.

Инкрементальная синхронизация. У заказов появилось поле updatedAt. Списки заказов, товаров и клиентов принимают filter[updatedAt][from|to] и сортировку order=updatedAt:asc. Подробнее.

Товары и клиенты. Новые методы GET /api/v1/products, GET /api/v1/products/{id} (по ID, внешнему ID или артикулу), GET /api/v1/customers и GET /api/v1/customers/{id}.

Позиции заказа по артикулу. В POST /api/v1/orders товар в позиции можно указать через sku или externalProductId. Без unitPrice берётся цена из каталога.

Права ключей. Права products:write и customers:write больше не выдаются: методов записи для товаров и клиентов пока нет.

Июнь 2026

Первая версия API: заказы (список, получение, создание, изменение), справочники, проверка ключа.

На странице