# Отримати список програм APP

Виводить застосунки, які можна встановити на хмарний телефон.
- **Ефект**: відсутній. Лише читання. Повтор безпечний з обмеженою витримкою. Хмарний телефон не задіяний, тому він не мусить бути запущений.
- **Вміст**: публічний каталог застосунків, тобто глобально доступні застосунки плюс опубліковані для вашої команди. Кожен запис містить свої версії в `appVersionList`, починаючи з найновіших; беріть `appVersionList[].id` як `appVersionId` для `/cloudphone/app/install`.
- **Особливість пагінації**: результати перевпорядковуються після отримання сторінки, тому порядок стабільний лише в межах сторінки, а `total` відображає поточну сторінку, а не весь каталог. Для навігації використовуйте `pages`.

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

## 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)
    Ідентифікатор застосунку. Це не те значення, яке очікує `/cloudphone/app/install`.

  - `data.dataList.appName` (string)
    Назва застосунку

  - `data.dataList.appIcon` (string)
    URL піктограми застосунку

  - `data.dataList.packageName` (string)
    Ім'я пакета Android

  - `data.dataList.categoryValue` (integer)
    Ідентифікатор категорії

  - `data.dataList.sortNo` (integer)
    Порядок сортування в бібліотеці застосунків

  - `data.dataList.appVersionList` (array)
    Версії застосунку, відсортовані за `versionCode` за спаданням (новіші спершу)

  - `data.dataList.appVersionList.id` (string)
    Ідентифікатор версії застосунку. Передайте його як `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)