Перейти к основному содержимому

Заказы

Маршруты раздела «Заказы» для интеграции Cloud API.

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

Оплаченные заказы отделены от операций VPS. Статусы: pending, processing, completed, failed, refunded, review. completed при покупке дедика означает резерв, а не выдачу. review — неопределённый или частичный результат, требующий выяснения; не создавайте повторную покупку. parameters содержит только публичные поля без паролей и себестоимости.

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

Оплаченные заказы отделены от операций VPS. Статусы: pending, processing, completed, failed, refunded, review. completed при покупке дедика означает резерв, а не выдачу. review — неопределённый или частичный результат, требующий выяснения; не создавайте повторную покупку. parameters содержит только публичные поля без паролей и себестоимости.

📄️Очередь заказа

Возвращает очередь создания VPS, купленного этой интеграцией. Передавайте order_id Cloud API, а не operation_id. status — состояние операции выдачи: queued, running, succeeded, failed или cancelled; оно отличается от финансового статуса заказа. position — место среди ожидающих в локации/на платформе либо null вне очереди. waiting — общее количество ожидающих для всех покупателей. Числа могут отставать до пяти секунд; при размещении могут пропускаться заказы, которым не хватает текущих ресурсов. can_cancel=true означает возможность отмены на момент чтения, без её резервирования. reason: node_busy, node_unavailable, ip_pool_exhausted, network_pool_empty либо null. Пока заказ не передан на выдачу, возвращается 409 queue_not_ready: проверяйте GET /orders/{order_id} и повторяйте запрос, пока заказ pending или processing. Для других типов заказов — 409 not_vm_purchase.

📄️Отмена очереди VPS

Отменяет ожидающую покупку VPS до резервирования ресурсов и начала выдачи. Передавайте order_id Cloud API. Тела запроса нет; api_key_id передаётся в query. Idempotency-Key не нужен: повтор DELETE того же отменённого заказа возвращает заказ с возвратом, не начисляя деньги повторно. HTTP 200 подтверждает отмену и возврат исходной списанной суммы на баланс интеграции. Бесплатная административная выдача остаётся бесплатной. Финансовый статус заказа — refunded, error_code=creation_cancelled; статус операции выдачи — cancelled. Отправляются вебхуки order.refunded и vm.creation_cancelled. Если выдача уже началась, возвращается 409 queue_cancel_unavailable без возврата. До передачи на выдачу — 409 queue_not_ready; для других типов заказов — 409 not_vm_purchase. Ответ 503 не означает, что отмена не произошла: проверьте заказ и повторите тот же DELETE. Маршрут не удаляет выданный VPS и не отменяет аренду дедика.

© 2026 AdaptGroup LLC. All rights reserved.
30 N Gould St Ste R, Sheridan, WY 82801, USA
Back to top