# クラウドフォンにアプリをインストールする

チームのアプリライブラリからクラウドフォンへアプリをインストールします。
- **前提条件**：クラウドフォンが起動済みで、他のメンバーに占有されていないこと。アプリはチームライブラリまたは公開カタログに既に存在している必要があり、`appVersionId` か `packageName` + `versionCode` のいずれかで指定します。また、そのクラウドフォンを提供するデバイスサービスへアップロード済みでなければインストールは失敗します。
- **レート制限**：1 台につき 1 秒あたり 1 回まで。これより早い 2 回目の呼び出しは拒否されます。
- **完了シグナル**：**受理されただけで、完了ではありません。** レスポンスはリクエストがキューに入ったことのみを示します。`/cloudphone/app/installedList` をポーリングしてアプリが届いたか確認してください。
- **リトライ**：インストール済み一覧を確認した上で、1 秒 1 回の制限を守れば安全にリトライできます。

文書化されたビジネスエラー: `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

  - `id` (string, required)
    クラウド電話ID

  - `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)