# 获取 APP 应用列表

列出可安装到云手机的应用。
- **副作用**：无。只读。可带退避安全重试。 不涉及具体云手机，因此不要求云手机处于运行状态。
- **返回内容**：公共应用市场——全局可用的应用，加上定向对你团队开放的应用。每条记录的版本在 `appVersionList` 中按新版在前排列；取 `appVersionList[].id` 作为 `/cloudphone/app/install` 的 `appVersionId`。
- **分页注意**：结果在取到当页之后才重新排序，所以排序只在页内稳定，`total` 反映的是当前页而不是整个应用市场。分页请用 `pages`。

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

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `appName` (string)
    应用名称（模糊匹配）

  - `pageNum` (integer)
    页码；默认：1

  - `pageSize` (integer)
    每页条数；默认：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。作为 `appVersionId` 传给 `/cloudphone/app/install`。

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