# Chụp màn hình điện thoại đám mây

Chụp màn hình cloud phone và trả về một URL tải về.
- **Điều kiện tiên quyết**: cloud phone phải đang bật và không bị thành viên khác chiếm giữ. Chỉ hỗ trợ trên thiết bị tương thích; các mẫu thiết bị khác từ chối lệnh gọi.
- **Tác động**: Trên một số mẫu, tệp ảnh chụp được xóa khỏi thiết bị sau khi đã chụp.
- **Hoàn tất**: đồng bộ. Phản hồi chứa URL tải ảnh tạm thời.
- **Lưu ý**: Trên một số mẫu, thời hạn được báo về là đúng một giờ tính từ lúc phản hồi và `success` luôn bằng true — đó không phải thời hạn thực của chữ ký. Hãy tải ảnh về ngay thay vì lưu lại URL.
- **Thử lại**: không có tác động nào ngoài chính việc chụp, nên gọi lại là an toàn.

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

## Request fields (application/json):

  - `id` (string, required)
    ID Cloud Phone
    Example: 1558968155668507

## Response 200:

  - `200` (unknown)
    Thành công. `data` là một đối tượng với các trường `url`, `status`, `expireAt` và `success`.

## Response 200 fields (application/json):

  - `code` (integer)
    Mã phản hồi: 0 = thành công, >0 = lỗi

  - `data` (object)

  - `data.url` (string)
    URL truy cập ảnh chụp màn hình
    Example: http://oss.morelogin.com/test.png

  - `data.status` (string)
    Trạng thái cho biết hoàn tất ngay ("finish") hoặc đang chờ ("pending")
    Example: finish

  - `data.expireAt` (string)
    Dấu thời gian hết hạn của URL tính bằng mili giây (chỉ dành cho một số mẫu thiết bị)
    Example: 1756024767163

  - `data.success` (boolean)
    Đã tạo thành công
    Example: true

  - `msg` (string | null)
    Thông báo; có giá trị khi code > 0

  - `requestId` (string)
    Định danh yêu cầu duy nhất; hãy cung cấp khi liên hệ hỗ trợ