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

Получение заказа

Прочитайте текущее состояние одного принадлежащего аккаунту заказа и определите финал доставки.

GET /v1/energy/orders/{id}

На этой странице

Используйте UUID из ответа создания или путь из Location.

Параметр пути

Параметр	Тип	Описание
`id`	UUID	Публичный идентификатор заказа.

Ответ 200

{"id":"7c0c9a54-517c-4bbb-a946-bf14bf86c113","client_request_id":"order-1042","address":"TXYZ","energy":65000,"duration_hours":1,"total_trx":"3.200000","status":"delivered","lifecycle_final":false,"delivery_final":true,"created_at":1784376000,"updated_at":1784376012,"failure":null}

Поле	Тип	Описание
`status`	string	`created`, `executing`, `delivered`, `rental_finished`, `failed` или `rental_interrupted`.
`lifecycle_final`	boolean	Вся аренда завершена; дальнейших переходов не будет.
`delivery_final`	boolean	Попытка доставки завершена. `true` не означает успех — проверьте `failure`.
`failure`	object или null	Стабильный `code` и безопасный `message` при неуспехе.
`created_at`, `updated_at`	integer	Unix-время в секундах.

Когда прекратить опрос

Останавливайтесь только когда оба флага равны true. Успешный полный цикл заканчивается rental_finished. failed и rental_interrupted содержат failure.

Не найдено

Отсутствующий и принадлежащий другому аккаунту ID одинаково возвращают:

{"type":"https://rentron.xyz/docs/errors/codes#energy_order_not_found","title":"Not Found","status":404,"detail":"Order was not found.","code":"energy_order_not_found"}