Синхронизация

Заказы, товары и клиенты хранят updatedAt: время последнего изменения. Любая правка записи его сдвигает, будь то статус, оплата, позиции заказа или контакты. На этом строится инкрементальная выгрузка.

Первая выгрузкаCopy Anchor Link

Заберите всё, листая страницы курсором:

curl "https://refsales.ru/api/v1/orders?order=updatedAt:asc&limit=100&with=items" \
  -H "Authorization: Bearer rsk_live_xxx"

Запомните updatedAt последней записи на последней странице. Это ваша точка отсчёта.

Следующие запускиCopy Anchor Link

Запрашивайте записи, изменённые после точки отсчёта:

curl "https://refsales.ru/api/v1/orders?order=updatedAt:asc&filter[updatedAt][from]=2026-09-27T18:30:00.000Z&limit=100" \
  -H "Authorization: Bearer rsk_live_xxx"

Фильтр включает границу, поэтому последняя запись прошлого запуска придёт снова. Сверяйте по id и обновляйте её, а не создавайте заново.

После прохода по всем страницам сдвиньте точку отсчёта на updatedAt последней полученной записи.

ПравилаCopy Anchor Link

• Сортируйте по updatedAt:asc. При desc запись, изменённая во время обхода, может уехать на уже пройденную страницу.
• Курсор привязан к сортировке. Курсор из выдачи createdAt с updatedAt не сработает, API вернёт 400.
• Не опрашивайте чаще раза в минуту: лимит 7 запросов в секунду на ключ делится между всеми вашими процессами.
• Удалённые клиенты в выдачу не попадают. Если клиент пропал из API, удалите его у себя при следующей полной сверке.

Те же параметры работают для /api/v1/products и /api/v1/customers.