# Descarga de archivos

Descarga un archivo desde un Cloud Phone.
- **Requisitos previos**: el teléfono debe estar encendido y no puede estar retenido por otro miembro del equipo.
- **Efecto**: el servicio recorre primero el directorio padre y solo después inicia la transferencia, así que una ruta inexistente falla **aquí** y no en la consulta de estado. Debe corresponder a un archivo normal, no a un directorio.
- **Finalización**: **aceptado, no completado.** La respuesta devuelve `downId`; consulta `/cloudphone/download/result` hasta que el estado sea correcto, fallido o cancelado. Ese endpoint vuelve a comprobar que el teléfono sigue encendido y sigue siendo tuyo.
- **Reintentos**: no es idempotente: cada llamada vuelve a recorrer el directorio y emite un `downId` nuevo.

Errores de negocio documentados: `33300`, `33301`, `33507`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para el significado de cada código. Cualquier operación puede devolver además los códigos comunes.

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

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string, required)
    cloud phone id

  - `filePath` (string, required)
    file path: /sdcard/Download/a.txt

## Response 200:

  - `200` (unknown)
    Success. `data` is an object with the fields `id` and `downId`.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Response code, 0 indicates success,>0 indicates failure

  - `msg` (string | null, required)

  - `data` (object, required)

  - `data.id` (string, required)
    Cloud phone id

  - `data.downId` (string, required)
    File download id

  - `requestId` (string, required)