# Отримання відомостей про хмарний телефон за AndroidId

Знаходить хмарний телефон за Android ID, який повідомляє пристрій.
- **Ефект**: відсутній. Лише читання. Повтор безпечний з обмеженою витримкою. Телефон не мусить бути увімкнений.
- **Повертає**: ту саму структуру відомостей, що й `/cloudphone/info`.
- **Крайні випадки**: порожній `androidId` повертає успіх із `data`, що дорівнює null, а не помилку валідації; а якщо один Android ID спільний для кількох телефонів, довільно повертається один із них.

Endpoint: POST /api/cloudphone/queryByAndroidId
Version: 2026-09-05

## Request fields (application/json):

  - `androidId` (string, required)
    androidId хмарного телефона
    Example: 8f7e6d5c4b3a2f1e

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `code` (integer, required)
    Example: 0

  - `msg` (string | null, required)
    Example: null

  - `data` (object, required)

  - `data.id` (string, required)
    ID хмарного телефона

  - `data.androidId` (string)
    android id хмарного телефона

  - `data.gaid` (string)
    gaid хмарного телефону

  - `data.envName` (string, required)
    Назва хмарного телефона

  - `data.groupId` (string, required)
    Ідентифікатор групи

  - `data.groupName` (string | null)
    Назва групи. Null, якщо хмарний телефон не належить до жодної групи

  - `data.skuId` (string, required)
    ID SKU продукту

  - `data.tagInfos` (array, required)
    Відомості про теги. Порожній масив, якщо теги не призначено

  - `data.tagInfos.id` (string, required)
    Ідентифікатор тегу

  - `data.tagInfos.tagName` (string, required)
    Назва тегу

  - `data.billingType` (integer, required)
    Тип тарифікації: 1 = похвилинна оплата (на вимогу), 2 = місячна

  - `data.proxyStatus` (integer, required)
    Статус проксі: 0 = не перевірено, 1 = перевіряється, 2 = перевірка не вдалася, 3 = перевірка успішна

  - `data.settings` (object, required)
    Розширені налаштування відбитка

  - `data.settings.automaticGeo` (boolean, required)

  - `data.settings.automaticLocation` (boolean, required)

  - `data.settings.automaticLanguage` (boolean, required)

  - `data.settings.longitude` (number | null, required)

  - `data.settings.latitude` (number | null, required)

  - `data.device` (object, required)
    Дані про обладнання пристрою

  - `data.device.server` (string | null, required)

  - `data.device.countryName` (string, required)

  - `data.device.rom` (integer, required)

  - `data.device.wifiBssid` (string | null, required)

  - `data.device.bluetoothMac` (string, required)

  - `data.proxy` (object, required)
    Налаштування проксі

  - `data.proxy.id` (string, required)

  - `data.proxy.proxyName` (string, required)

  - `data.proxy.state` (string | null)
    Штат або область проксі. Пріоритет має визначене розташування вихідного IP, далі використовується налаштоване; можливі null або порожній рядок.
    Example: California

  - `data.proxy.city` (string | null)
    Місто проксі. Пріоритет має визначене розташування вихідного IP, далі використовується налаштоване; можливі null або порожній рядок.
    Example: Los Angeles

  - `data.proxy.proxyPort` (integer | null)
    Порт підключення до проксі; не визначається з імені проксі. Може бути null, якщо недоступний.
    Example: 1080

  - `data.proxy.proxyIp` (string, required)

  - `data.lastStartMemberId` (string, required)
    Ідентифікатор учасника останнього запуску

  - `data.lastStartMemberName` (string | null, required)
    Ім'я учасника останнього запуску

  - `data.lastStartDate` (string, required)
    Час останнього запуску

  - `data.lastConnectMemberId` (string, required)
    Ідентифікатор учасника останнього підключення

  - `data.lastConnectMemberName` (string | null, required)
    Ім'я учасника останнього підключення

  - `data.lastConnectDate` (string, required)
    Час останнього підключення

  - `data.envStatus` (integer, required)
    Статус середовища: 0 = нове, 1 = помилка створення, 2 = вимкнено, 3 = завантажується, 4 = увімкнено, 5 = скидається, 6 = перезавантажується, 7 = виконується зміна пристрою в один клік

  - `data.abnormalStatus` (integer, required)
    Аварійний статус: 0 = норма, 1 = не активований, 2 = заборгованість, 3 = перепроданий, 4 = деактивований

  - `data.expireTime` (string, required)
    Час завершення дії

  - `data.envRemark` (string, required)
    Примітка до середовища

  - `data.createMember` (string, required)
    Ідентифікатор учасника-створювача

  - `data.updateMember` (string, required)
    Ідентифікатор учасника, який виконав оновлення

  - `data.updateDate` (string, required)
    Час оновлення

  - `data.createDate` (string, required)
    Час створення

  - `data.createMemberName` (string | null, required)
    Ім'я учасника-створювача

  - `requestId` (string, required)
    Example: 4d0f4fa68613441e9a11446a6437bb5a