# Загрузка файла

Скачивает файл с облачного телефона.
- **Предварительные условия**: облачный телефон должен быть включён и не должен быть занят другим участником команды.
- **Эффект**: служба сначала обходит родительский каталог и только затем начинает передачу, поэтому несуществующий путь приводит к ошибке **здесь**, а не при опросе статуса. Цель должна быть обычным файлом, а не каталогом.
- **Завершение**: **принято, но не завершено.** Ответ возвращает `downId`; опрашивайте `/cloudphone/download/result`, пока статус не станет успешным, ошибочным или отменённым. Этот эндпоинт заново проверяет, что телефон по-прежнему включён и по-прежнему занят вами.
- **Повтор**: не идемпотентно — каждый вызов заново обходит каталог и выдаёт новый `downId`.

Задокументированные бизнес-ошибки: `33300`, `33301`, `33507`. Значения кодов см. в [Error Codes](../Getting%20Started/error-codes.md). Любая операция может дополнительно вернуть общие коды.

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)