# Стартап облачного телефона

Включает облачный телефон.
- **Предварительные условия**: телефон должен быть выключен. Вызов отклоняется, когда 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)
    Отображать окно Cloud Phone. 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)
    Идентификатор запроса на операцию