# Captura de pantalla del teléfono en la nube

Captura la pantalla del Cloud Phone y devuelve una URL de descarga.
- **Requisitos previos**: el teléfono debe estar encendido y no puede estar retenido por otro miembro del equipo. Compatible solo con dispositivos compatibles; los demás modelos rechazan la llamada.
- **Efecto**: En algunos modelos el archivo de la captura se elimina del dispositivo después de tomarla.
- **Finalización**: sincrónica. La respuesta incluye una URL temporal para descargar la imagen.
- **Advertencia**: En algunos modelos la caducidad informada es una hora fija desde la respuesta y `success` siempre es true; no es la vigencia real de la firma. Descarga la imagen cuanto antes en lugar de guardar la URL.
- **Reintentos**: no hay más efecto que la propia captura, así que es seguro repetir.

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

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string, required)
    ID del teléfono en la nube
    Example: 1558968155668507

## Response 200:

  - `200` (unknown)
    Correcto. `data` es un objeto con los campos `url`, `status`, `expireAt` y `success`.

## Response 200 fields (application/json):

  - `code` (integer)
    Código de respuesta: 0 = correcto, >0 = error

  - `data` (object)

  - `data.url` (string)
    URL de acceso a la captura de pantalla
    Example: http://oss.morelogin.com/test.png

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

  - `data.expireAt` (string)
    Marca de tiempo de caducidad de la URL en milisegundos (solo para algunos modelos)
    Example: 1756024767163

  - `data.success` (boolean)
    Se generó correctamente
    Example: true

  - `msg` (string | null)
    Mensaje; se rellena si code > 0

  - `requestId` (string)
    Identificador único de la solicitud; indíquelo al contactar con soporte