# アプリ一覧を取得する

クラウドフォンにインストール可能なアプリを一覧します。
- **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。クラウドフォンは関与しないため、起動している必要はありません。
- **返却内容**：公開アプリカタログ、すなわち全体公開のアプリと自チーム向けに公開されたアプリです。各エントリは `appVersionList` にバージョンを新しい順で保持します。`/cloudphone/app/install` の `appVersionId` には `appVersionList[].id` を使ってください。
- **ページングの注意**：ページ取得後に並べ替えが行われるため、順序が安定するのはページ内だけで、`total` はカタログ全体ではなく現在のページを反映します。ナビゲーションには `pages` を使ってください。

Endpoint: POST /api/cloudphone/app/page
Version: 2026-09-05

## Request fields (application/json):

  - `appName` (string)
    アプリ名（部分一致）

  - `pageNum` (integer)
    ページ番号；デフォルト：1

  - `pageSize` (integer)
    1 ページあたりの件数；デフォルト：10

## Response 200:

  - `200` (unknown)
    成功。`data.dataList` は要求されたページでチームが利用できるアプリです。各アプリのバージョンは `appVersionList` に新しい順で入ります。`data.total` は現在のページの件数で総件数ではありません。ページングには `data.pages` を使用してください。

## Response 200 fields (application/json):

  - `code` (integer)

  - `msg` (string | null)

  - `data` (object)

  - `data.total` (string)
    現在のページの件数

  - `data.current` (string)
    現在のページ番号

  - `data.pages` (string)
    総ページ数

  - `data.dataList` (array)

  - `data.dataList.id` (string)
    アプリ ID。`/cloudphone/app/install` が必要とする値ではありません。

  - `data.dataList.appName` (string)
    アプリ名

  - `data.dataList.appIcon` (string)
    アプリアイコンの URL

  - `data.dataList.packageName` (string)
    Android パッケージ名

  - `data.dataList.categoryValue` (integer)
    カテゴリ ID

  - `data.dataList.sortNo` (integer)
    アプリライブラリの並び順

  - `data.dataList.appVersionList` (array)
    このアプリのバージョン。`versionCode` の降順（新しい順）

  - `data.dataList.appVersionList.id` (string)
    アプリバージョン ID。`/cloudphone/app/install` の `appVersionId` に渡します。

  - `data.dataList.appVersionList.versionCode` (string)
    バージョンコード

  - `data.dataList.appVersionList.versionName` (string)
    バージョン表示名

  - `data.dataList.appVersionList.installStatus` (integer | null)
    この操作では常に null です。インストール状態は `/cloudphone/app/installedList` で照会してください。

  - `data.dataList.appVersionList.packageName` (string | null)
    この操作では常に null です。アプリ階層の `packageName` を使用してください。

  - `requestId` (string)