# Obtenha a lista de aplicativos.

Lista os apps que podem ser instalados em um Cloud Phone.
- **Efeito**: nenhum. Somente leitura. É seguro repetir com recuo limitado. Nenhum Cloud Phone é envolvido, então o telefone não precisa estar em execução.
- **Conteúdo**: o catálogo público de apps, isto é, os apps disponíveis globalmente mais os publicados para a sua equipe. Cada entrada traz suas versões em `appVersionList`, da mais nova para a mais antiga; use `appVersionList[].id` como o `appVersionId` de `/cloudphone/app/install`.
- **Ressalva sobre a paginação**: os resultados são reordenados após a página ser obtida, portanto a ordem só é estável dentro de uma página e `total` reflete a página atual em vez do catálogo completo. Use `pages` para navegar.

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

## Request fields (application/json):

  - `appName` (string)
    Nome do app (correspondência parcial)

  - `pageNum` (integer)
    Número da página; padrão: 1

  - `pageSize` (integer)
    Itens por página; padrão: 10

## Response 200:

  - `200` (unknown)
    Sucesso. `data.dataList` contém os aplicativos disponíveis para sua equipe na página solicitada; cada aplicativo traz suas versões em `appVersionList`, a mais recente primeiro. `data.total` é o número de registros da página atual, não o total — use `data.pages` para a paginação.

## Response 200 fields (application/json):

  - `code` (integer)

  - `msg` (string | null)

  - `data` (object)

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

  - `data.current` (string)
    Número da página atual

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

  - `data.dataList` (array)

  - `data.dataList.id` (string)
    ID do aplicativo. Não é o valor que `/cloudphone/app/install` espera.

  - `data.dataList.appName` (string)
    Nome do aplicativo

  - `data.dataList.appIcon` (string)
    URL do ícone do aplicativo

  - `data.dataList.packageName` (string)
    Nome do pacote Android

  - `data.dataList.categoryValue` (integer)
    ID da categoria

  - `data.dataList.sortNo` (integer)
    Ordem usada pela biblioteca de aplicativos

  - `data.dataList.appVersionList` (array)
    Versões deste aplicativo, ordenadas por `versionCode` de forma decrescente (mais recente primeiro)

  - `data.dataList.appVersionList.id` (string)
    ID da versão do aplicativo. Passe este valor como `appVersionId` para `/cloudphone/app/install`.

  - `data.dataList.appVersionList.versionCode` (string)
    Código da versão

  - `data.dataList.appVersionList.versionName` (string)
    Nome de exibição da versão

  - `data.dataList.appVersionList.installStatus` (integer | null)
    Sempre null nesta operação. Consulte o estado de instalação com `/cloudphone/app/installedList`.

  - `data.dataList.appVersionList.packageName` (string | null)
    Sempre null nesta operação; use o `packageName` do nível do aplicativo.

  - `requestId` (string)