# Captura de tela do telefone na nuvem

Captura a tela do Cloud Phone e retorna uma URL de download.
- **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. Compatível apenas com dispositivos compatíveis; os outros modelos rejeitam a chamada.
- **Efeito**: Em alguns modelos o arquivo da captura é removido do dispositivo depois de ser gerado.
- **Conclusão**: sincrônica. A resposta inclui uma URL temporária para baixar a imagem.
- **Ressalva**: Em alguns modelos a expiração informada é de uma hora fixa a partir da resposta e `success` é sempre true; esse não é o tempo real de validade da assinatura. Baixe a imagem logo em vez de guardar a URL.
- **Nova tentativa**: não há efeito além da própria captura, então é seguro repetir.

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

## Request fields (application/json):

  - `id` (string, required)
    ID do telefone na nuvem
    Example: 1558968155668507

## Response 200:

  - `200` (unknown)
    Sucesso. `data` é um objeto com os campos `url`, `status`, `expireAt` e `success`.

## Response 200 fields (application/json):

  - `code` (integer)
    Código de resposta: 0 = sucesso, >0 = erro

  - `data` (object)

  - `data.url` (string)
    URL de acesso à captura de tela
    Example: http://oss.morelogin.com/test.png

  - `data.status` (string)
    Status que indica conclusão imediata ("finish") ou status pendente ("pending")
    Example: finish

  - `data.expireAt` (string)
    Timestamp de expiração da URL em milissegundos (apenas para alguns modelos)
    Example: 1756024767163

  - `data.success` (boolean)
    Whether the URL was successfully generated
    Example: true

  - `msg` (string | null)
    Mensagem; preenchida se code > 0

  - `requestId` (string)
    Identificador único da solicitação; informe-o ao contatar o suporte