# 通过 AndroidId 获取云手机详情

通过设备上报的 Android ID 查找云手机。
- **副作用**：无。只读。可带退避安全重试。 云手机不需要已开机。
- **返回**：与 `/cloudphone/info` 相同的详情结构。
- **边界情况**：`androidId` 为空时返回成功但 `data` 为 null，而不是参数校验错误；若多台云手机共用同一个 Android ID，则任意返回其中一台。

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

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `androidId` (string, required)
    云手机的 androidId
    Example: 8f7e6d5c4b3a2f1e

## Response 200:

  - `200` (unknown)
    成功

## Response 200 fields (application/json):

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

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

  - `data` (object, required)

  - `data.id` (string, required)
    ml云手机Id

  - `data.androidId` (string)
    云手机 android id

  - `data.gaid` (string)
    云手机 gaid

  - `data.envName` (string, required)
    环境名称

  - `data.groupId` (string, required)
    分组Id

  - `data.groupName` (string | null)
    分组名称；未分组时为 null

  - `data.skuId` (string, required)
    商品ID

  - `data.tagInfos` (array, required)
    标签信息；无标签时返回空数组

  - `data.tagInfos.id` (string, required)
    标签 ID

  - `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)
    最后开机人ID

  - `data.lastStartMemberName` (string | null, required)
    最后开机人名称

  - `data.lastStartDate` (string, required)
    最后开机时间

  - `data.lastConnectMemberId` (string, required)
    最后一次连接人ID

  - `data.lastConnectMemberName` (string | null, required)
    最后一次连接人名称

  - `data.lastConnectDate` (string, required)
    最后连接时间

  - `data.envStatus` (integer, required)
    环境状态: 0 新建 1 创建失败 2 关机 3 开机中 4 开机 5 重置中 6 重启中

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