# 云手机截屏

截取云手机屏幕并返回下载地址。
- **前置条件**：云手机必须已开机且未被其他成员占用。仅兼容机型支持，不兼容机型会拒绝该调用。
- **副作用**：在部分机型上，截图文件在拍摄后会从设备中删除。
- **完成信号**：同步。响应包含临时图片下载地址。
- **注意**：在部分机型上返回的过期时间是响应时刻起固定一小时、`success` 恒为 true——它不是真实的签名有效期。请及时下载，不要存这个 URL。
- **重试**：除截图本身外没有副作用，可以安全重复调用。

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

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

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

## Response 200:

  - `200` (unknown)
    成功。`data` 是对象，包含字段 `url`、`status`、`expireAt`、`success`。

## Response 200 fields (application/json):

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

  - `data` (object)

  - `data.url` (string)
    截图访问地址
    Example: http://oss.morelogin.com/test.png

  - `data.status` (string)
    Status representing immediate completion ("finish") or pending status ("pending")
    Example: finish

  - `data.expireAt` (string)
    URL 过期时间戳，单位毫秒（仅部分机型返回）
    Example: 1756024767163

  - `data.success` (boolean)
    是否生成成功
    Example: true

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

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