# 启用应用 ROOT

为云手机上指定的应用包授予 ROOT。
- **前置条件**：云手机必须已开机且未被其他成员占用。仅兼容机型支持；不兼容机型调用会成功但无实际效果。
- **副作用**：把包名白名单下发到设备，并顺带打开 ROOT 总开关。**MoreLogin 不做任何存储**，因此无法通过接口回读该授权。
- **完成信号**：设备服务同步受理。ROOT 何时在设备上生效由设备服务决定；MoreLogin 不会重启云手机。
- **说明**：目前没有按单个包名撤销 ROOT 的接口。要关闭请用 `/cloudphone/enableRoot` 关掉总开关。

已记录的业务错误码：`33300`, `33301`。 各错误码的含义见 [Error Codes](../Getting%20Started/error-codes.md)。任何接口还可能返回通用错误码。

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

## Request fields (application/json):

  - `id` (string, required)
    云手机 ID
    Example: 12345678

  - `packageNames` (array, required)
    允许获取 ROOT 权限的应用包名列表
    Example: ["com.test"]

## Response 200:

  - `200` (unknown)
    成功。`data` 是单个布尔值。

## Response 200 fields (application/json):

  - `code` (integer)
    响应码：0 = 成功，>0 = 失败

  - `data` (boolean)

  - `msg` (string | null)
    错误信息；code > 0 时返回

  - `requestId` (string)
    请求唯一标识；联系支持时请提供