Документация для разработчиков

Пространство API
https://api.rentron.xyz/v1
Схема OpenAPI

Список заказов

// GET

API для реальных заказов

Список заказов

Получайте заказы от новых к старым с помощью непрозрачного курсора.

GET /v1/energy/orders?limit=20&cursor=...
На этой странице

Метод возвращает только заказы аккаунта, связанного с API-ключом.

Параметры строки запроса

Параметр Тип По умолчанию Описание
limit integer 20 Размер страницы от 1 до 100.
cursor string Непрозрачный курсор из предыдущего next_cursor.

В подпись входит точная строка параметров вместе с ведущим ?. Не сортируйте и не кодируйте её повторно после подписания.

Ответ 200

{"items":[{"id":"7c0c9a54-517c-4bbb-a946-bf14bf86c113","client_request_id":"order-1042","address":"TXYZ","energy":65000,"duration_hours":1,"total_trx":"3.200000","status":"created","lifecycle_final":false,"delivery_final":false,"created_at":1784376000,"updated_at":1784376000,"failure":null}],"next_cursor":"opaque-value"}

items отсортирован от новых к старым. Если next_cursor равен null, страниц больше нет.

Правила курсора

  • Передавайте курсор без изменений.
  • Не декодируйте и не конструируйте его самостоятельно.
  • Курсор привязан к аккаунту и ресурсу.
  • Некорректный, изменённый или чужой курсор возвращает 400 с кодом pagination_cursor_invalid.