# Download do arquivo

Baixa um arquivo de um Cloud Phone.
- **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe.
- **Efeito**: o serviço percorre primeiro o diretório pai e só então inicia a transferência, então um caminho inexistente falha **aqui** e não na consulta de status. Precisa corresponder a um arquivo comum, não a um diretório.
- **Conclusão**: **aceito, não concluído.** A resposta retorna `downId`; consulte `/cloudphone/download/result` até que o status seja concluído, falhou ou cancelado. Esse endpoint verifica novamente se o telefone continua ligado e continua sendo seu.
- **Nova tentativa**: não é idempotente — cada chamada refaz a varredura e emite um novo `downId`.

Erros de negócio documentados: `33300`, `33301`, `33507`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

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)