# 获取云手机远程连接链接

创建云手机临时网页访问链接（仅 Open API）。
- **前提**：云手机须属于当前团队，调用成员具有资源权限，已开机且未被其他成员占用。本接口不会自动开机。
- **效果**：每次调用生成新链接，不申请连接凭证，也不改变当前连接。在浏览器打开 `data.url`，或将完整 URL 生成二维码使用。
- **有效期**：从生成起固定 5 分钟，重复访问不消耗链接、不续期；到期后重新调用本接口。不返回 `expiredTime` 字段，此有效期不代表连接凭证有效期。
- **连接**：每次成功访问都会申请新的连接凭证并重定向至远控页面，可能影响之前的连接。访问失败可在剩余有效期内重试。生成链接成功不保证后续连接成功。
- **保管**：完整 URL 应按敏感凭证保管。接口响应带有 `Cache-Control: no-store`。直接使用返回的 URL，域名及连接参数由服务端决定。

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

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

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string, required)
    MoreLogin 云手机 ID。

  - `lang` (string)
    页面语言，例如 `zh-CN` 或 `en-US`。不传或空白时沿用请求语言，不支持时回退配置的默认语言。所选语言写入 URL，可修改其中的 `lang` 查询参数切换页面语言。

## Response 200:

  - `200` (unknown)
    成功。`data.url` 为临时网页访问链接，有效期 5 分钟。

## Response 200 fields (application/json):

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

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

  - `data` (object, required)

  - `data.url` (string, required)
    临时网页访问 URL，完整 URL 应按敏感凭证保管。
    Example: https://gateway.example.com/app/cloudphone/qrcodeUrl?token=0123456789abcdef0123456789abcdef&lang=en-US

  - `requestId` (string)

## Response 200 headers (application/json):

  - `Cache-Control` (string)
    不要缓存此响应。
    Enum: "no-store"