Заявки — Справочник API

Покупка и просмотр аренды ресурсов. В v1 нет отмены единичного заказа: POST /v1/orders списывает средства синхронно, поэтому заказ никогда не зависает неоплаченным в очереди, а статус created практически ненаблюдаем. Ошибка 3002 order_not_cancellable относится к POST /v1/batches/{id}/cancel, где получатели, взятые в обработку, уже не могут быть отменены.

Сгенерировано из openapi.yaml во время сборки. Базовый URL https://api.tenergy.me/v1 или https://api-nile.tenergy.me/v1 в сети Nile (Окружения). Каждый запрос ниже подписывается в соответствии с разделом Аутентификация, если в строке Аутентификация не указано иное.

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

GET /v1/orders · listOrders

Аутентификация: API-ключ (HMAC).

Сортировка от новых к старым. Фильтры объединяются по логическому AND.

Параметр format=csv возвращает text/csv со всеми подходящими заказами без разбивки на страницы (limit и cursor игнорируются) в потоковом режиме с тем же набором полей: одна колонка на каждое поле схемы Order, activation.* и failure.* развернуты, delegate_hashes разделены пробелами. Ячейки, начинающиеся со знаков =, +, -, @, табуляции или перевода строки, экранируются символом ' для защиты от выполнения формул в электронных таблицах.

Параметры

Ответы

Поля ответа

Создание заказа

POST /v1/orders · createOrder

Аутентификация: API-ключ (HMAC).

Покупает аренду ресурсов для одного получателя со списанием средств с баланса аккаунта.

Ответ не является распиской о доставке. Код 201 означает, что заказ принят, оплачен и передан поставщикам; поле status сообщает о текущем прогрессе. В стандартном случае доставка синхронна и в течение нескольких секунд возвращается заказ с заполненным delegate_hash — со статусом confirmed или active. Статусы confirmed и active равнозначны: в обоих ресурс уже находится на адресе получателя. Если поставщику требуется больше времени, вы получите статус allocating — опрашивайте GET /v1/orders/{id} или используйте вебхук order.confirmed.

Проверяйте флаг partial. Заказ, где часть объема не удалось выделить, возвращается как confirmed/active с флагом partial: true и возвратом разницы стоимости на баланс.

Идемпотентность. Всегда передавайте client_order_id. Повторный вызов с тем же ID возвращает существующий заказ с HTTP 200 без повторного списания средств. При таймауте сети повторите точно такой же запрос.

Защита цены. Передавайте quote_id (списание ровно по зафиксированной сумме) или max_price_sun (отклонение с 3006 price_above_limit, если цена выросла).

Параметры

Тело запроса

JSON (OrderRequest), обязательно.

Пример тела запроса из контракта (значения для иллюстрации):

{
  "client_order_id": "acme-2026-09-11-000418",
  "resource": "energy",
  "amount": 65000,
  "tier": "1h",
  "receiver": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "activate": true
}

Ответы

Поля ответа (Order)

Те же поля, что в ответе GET /v1/orders.

Детали заказа

GET /v1/orders/{orderId} · getOrder

Аутентификация: API-ключ (HMAC).

Возвращает заказ с дополнительной детализацией: fills (распределение по уровням цен) и delegations (фактические транзакции на чейне с их tx id).

Параметры

Ответы

Поля ответа

Содержит все поля объекта Order, а также:

Досрочный отзыв ресурса до истечения срока

POST /v1/orders/{orderId}/reclaim · reclaimOrder

Аутентификация: API-ключ (HMAC).

Досрочно отзывает делегирование ресурсов. Полезно, когда транзакция, ради которой арендовалась энергия, уже подтверждена в сети: энергия освобождается в общий пул.

Без возврата средств. Досрочный отзыв не возвращает оплату, а служит для освобождения складских запасов платформы крупными интеграторами.

Идемпотентно. Повторный вызов возвращает тот же reclaim_hash. Если аренда уже завершилась сама по истечении времени, эндпоинт также возвращает 200.

Заказы, исполненные сторонними поставщиками, не могут быть отозваны досрочно (возвращается 3008 reclaim_unavailable).

Параметры

Ответы

Поля ответа (Order)

Те же поля, что в объекте Order.

Пример ответа 200 из контракта (значения для иллюстрации):

{
  "id": "ord_01J9Z5P8T3WQ",
  "client_order_id": "acme-2026-09-11-000418",
  "account_id": "acc_01J9Z4K2M7Q8",
  "resource": "energy",
  "amount": 65000,
  "delivered_amount": 65000,
  "partial": false,
  "tier": "1h",
  "duration_seconds": 3600,
  "receiver": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "source": "api",
  "status": "reclaimed",
  "confirm_status": "confirmed",
  "price_sun_per_unit": 20,
  "pay_amount_sun": 1300000,
  "activate_amount_sun": 0,
  "total_amount_sun": 1300000,
  "refunded_amount_sun": 0,
  "delegate_hash": "a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90",
  "delegate_hashes": ["a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90"],
  "delegated_at": "2026-09-11T18:04:07.900Z",
  "reclaim_hash": "51fa77da06e8fbebf504fbf088d1d9611059398d51fa77da06e8fbebf504fbf0",
  "reclaimed_at": "2026-09-11T18:12:31.000Z",
  "expires_at": "2026-09-11T19:04:07.900Z",
  "activation": {"performed":false,"hash":null,"amount_sun":0},
  "created_at": "2026-09-11T18:04:05.400Z",
  "updated_at": "2026-09-11T18:12:31.000Z",
  "failure": null
}