# Obtener la lista de aplicaciones APP

Lista las apps que se pueden instalar en un Cloud Phone.
- **Efecto**: ninguno. Solo lectura. Es seguro reintentar con retroceso acotado. No interviene ningún Cloud Phone, así que el teléfono no necesita estar en ejecución.
- **Contenido**: el catálogo público de apps, es decir, las apps disponibles globalmente más las publicadas para tu equipo. Cada entrada lleva sus versiones en `appVersionList`, de más nueva a más antigua; toma `appVersionList[].id` como `appVersionId` para `/cloudphone/app/install`.
- **Advertencia sobre la paginación**: los resultados se reordenan después de obtener la página, por lo que el orden solo es estable dentro de una página y `total` refleja la página actual en lugar del catálogo completo. Usa `pages` para navegar.

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

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `appName` (string)
    Nombre de la app (coincidencia parcial)

  - `pageNum` (integer)
    Número de página; por defecto: 1

  - `pageSize` (integer)
    Elementos por página; por defecto: 10

## Response 200:

  - `200` (unknown)
    Correcto. `data.dataList` contiene las aplicaciones disponibles para su equipo en la página solicitada; cada aplicación lleva sus versiones en `appVersionList`, la más reciente primero. `data.total` es el número de registros de la página actual, no el total: use `data.pages` para la paginación.

## Response 200 fields (application/json):

  - `code` (integer)

  - `msg` (string | null)

  - `data` (object)

  - `data.total` (string)
    Número de registros de la página actual

  - `data.current` (string)
    Número de página actual

  - `data.pages` (string)
    Número total de páginas

  - `data.dataList` (array)

  - `data.dataList.id` (string)
    ID de la aplicación. No es el valor que espera `/cloudphone/app/install`.

  - `data.dataList.appName` (string)
    Nombre de la aplicación

  - `data.dataList.appIcon` (string)
    URL del icono de la aplicación

  - `data.dataList.packageName` (string)
    Nombre del paquete de Android

  - `data.dataList.categoryValue` (integer)
    ID de categoría

  - `data.dataList.sortNo` (integer)
    Orden usado por la biblioteca de aplicaciones

  - `data.dataList.appVersionList` (array)
    Versiones de esta aplicación, ordenadas por `versionCode` de forma descendente (la más reciente primero)

  - `data.dataList.appVersionList.id` (string)
    ID de versión de la aplicación. Pase este valor como `appVersionId` a `/cloudphone/app/install`.

  - `data.dataList.appVersionList.versionCode` (string)
    Código de versión

  - `data.dataList.appVersionList.versionName` (string)
    Nombre visible de la versión

  - `data.dataList.appVersionList.installStatus` (integer | null)
    Siempre null en esta operación. Consulte el estado de instalación con `/cloudphone/app/installedList`.

  - `data.dataList.appVersionList.packageName` (string | null)
    Siempre null en esta operación; use el `packageName` del nivel de aplicación.

  - `requestId` (string)