# Встановіть додаток на хмарний телефон

Установлює застосунок з бібліотеки команди на хмарний телефон.
- **Передумови**: хмарний телефон повинен бути увімкнений і не може бути зайнятий іншим учасником команди. Застосунок уже має існувати в бібліотеці команди або в публічному каталозі; укажіть його або через `appVersionId`, або через `packageName` разом із `versionCode`. Його також має бути завантажено до Сервіса, який обслуговує цей телефон, інакше встановлення не вдасться.
- **Обмеження частоти**: не більше одного встановлення на телефон за секунду; швидший повторний виклик відхиляється.
- **Завершення**: **прийнято, але не завершено.** Відповідь лише підтверджує, що запит поставлено в чергу. Опитуйте `/cloudphone/app/installedList`, щоб побачити, чи застосунок дійшов.
- **Повтор**: безпечний після перевірки списку встановлених, з урахуванням обмеження одного виклику за секунду.

Задокументовані бізнес-помилки: `33005`, `33014`, `33714`. Значення кодів див. у [Error Codes](../Getting%20Started/error-codes.md). Будь-яка операція може додатково повернути загальні коди.

Endpoint: POST /cloudphone/app/install
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `appVersionId` (string)
    Ідентифікатор версії програми

  - `id` (string, required)
    Ідентифікатор хмарного телефону

  - `packageName` (string)
    Назва пакета — обов’язкова, лише якщо не вказано appVersionId

  - `versionCode` (integer)
    Код версії — обов’язковий, лише якщо не вказано appVersionId

## Response 200:

  - `200` (unknown)
    Успіх. `data` — одне значення типу boolean.

## Response 200 fields (application/json):

  - `code` (integer)

  - `msg` (string | null)

  - `data` (boolean)

  - `requestId` (string)