Интеграция

Пагинация и история

Загрузка истории без потери записей и дубликатов в вашем приложении.

REST API v12 мин чтения

Offset-пагинация

GET /orders возвращает до 50 заказов от новых к старым. Первый запрос использует offset=0. Если hasMore=true, увеличьте offset на 50. Допустимый диапазон offset: 0–1000000.

GET /api/v1/orders

Client Libraries

9 языков
curl --request GET \
  --url "$LUFFY_BASE_URL"'/orders?offset=0' \
  --header "Authorization: Bearer $LUFFY_API_KEY" \
  --max-time 150 \
  --include --fail-with-body
cURL · shell

Новые заказы сдвигают страницы

Пагинация не является зафиксированным снимком. Пока вы загружаете следующую страницу, новые покупки могут сдвинуть записи. Делайте upsert по order.id и периодически перечитывайте начало истории. Не используйте offset как постоянный курсор синхронизации.

Общая история аккаунта

items включает заказы сайта, бота и API. Публичная схема не содержит источник покупки или Idempotency-Key. Для связи с внутренним пользователем вашего сервиса сохраните собственную таблицу соответствия internalUserId → order.id.

Не нашли ответ на свой вопрос?Помощь с интеграцией