# Стартап-хмарний телефон

Вмикає хмарний телефон.
- **Передумови**: телефон має бути вимкнений. Виклик відхиляється, коли SKU знято з продажу або він на обслуговуванні, коли телефон зайнятий іншим учасником, доки перевіряється його проксі, коли на рахунку заборгованість або телефон деактивований, коли сплив місячний період, а також коли недоступні ні безплатні хвилини, ні паралельний слот, ні позитивний баланс. Деякі моделі додатково потребують найновішої версії клієнта для Windows.
- **Ефект**: позначає телефон як такий, що завантажується, займає його для учасника, який викликає, і резервує паралельний слот або починає витрачати час. Відповідь повідомляє, що саме було використано.
- **Завершення**: **прийнято, але не завершено.** Опитуйте `/cloudphone/info`, доки `envStatus` не стане «увімкнений»; помилка проявиться там як `errorCode` і `errorMsg`. Учасники з налаштованим хостом зворотного виклику також отримують webhook.
- **Повтор**: другий одночасний виклик відхиляється відразу, а не ставиться в чергу. Після таймауту прочитайте `/cloudphone/info`, а не надсилайте запит повторно.

Задокументовані бізнес-помилки: `33300`, `33309`, `33315`, `33316`, `33317`, `33318`, `33321`, `33322`, `33323`, `33324`, `33325`, `33346`, `33347`, `33367`, `33376`, `33407`. Значення кодів див. у [Error Codes](../Getting%20Started/error-codes.md). Будь-яка операція може додатково повернути загальні коди.

Endpoint: POST /api/cloudphone/powerOn
Version: 2026-09-05

## Request fields (application/json):

  - `id` (string, required)

  - `headless` (boolean)
    Відображати вікно хмарного телефону. false: Відображати, true: Не відображати, За замовчуванням: true

  - `disableMoneySavingMode` (boolean)
    Вимкнути режим енергозбереження, за замовчуванням: false

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `code` (integer, required)
    Код результату повернення 0:Звичайний. Інші коди є винятками.

  - `msg` (string | null, required)
    Повідомлення про помилку

  - `requestId` (string, required)
    Ідентифікатор запиту на операцію