Рефсейлс API
ApiDiagnostics

Журнал событий

GET
/api/v1/events

Создание, изменение и удаление заказов, товаров и клиентов. События отсортированы от старых к новым и появляются в журнале через несколько минут. Внутри страниц используйте nextCursor, между запусками сохраняйте page.resumeCursor: он повторяет последние пять минут для защиты от поздних записей. В событии только идентификаторы, актуальное состояние заберите через соответствующий ресурс API. События доступны не менее 90 дней. Право: events:read.

Авторизация

bearerApiKey
headerАвторизацияBearer <rsk_live_…>

Ключ API в заголовке Authorization: Bearer rsk_live_…. Ключ создаёт владелец магазина: Настройки → Интеграции → API и вебхуки.

filter[type]?string

Только события этого типа.

Value in"order.created""order.updated""order.deleted""order.status_changed""order.payment_status_changed""product.created""product.updated""product.deleted""customer.created""customer.updated""customer.deleted"
filter[publishedAt][from]?string

Публикации не раньше указанного времени, ISO 8601 включительно.

Formatdate-time
cursor?string

Курсор из page.nextCursor предыдущего ответа. Работает только с той же сортировкой.

limit?integer

Размер страницы от 1 до 100. По умолчанию 50.

Ответ

Страница журнала событий.

application/json
  1. response
data*array<>
page*
Example Request
curl -X GET 'https://refsales.ru/api/v1/events'
Example Response
{  "data": [    {      "id": "5e8a1b3c-7d2f-4a6e-9c0b-81f4d2e6a9c7",      "type": "order.updated",      "createdAt": "2026-11-16T11:20:30.418Z",      "publishedAt": "2026-11-16T11:20:30.418Z",      "data": {        "orderId": "3f0e6c5a-2b7d-4e21-9a0f-6d1c8b4e7a52",        "externalId": "A-1001"      }    }  ],  "page": {    "nextCursor": null,    "hasMore": false,    "resumeCursor": "WyIyMDI2LTExLTE2VDExOjE1OjMwLjQxOFoiLCI1ZThhMWIzYy03ZDJmLTRhNmUtOWMwYi04MWY0ZDJlNmE5YzciLCJyIl0"  }}