# Завантаження файлу

Завантажує файл із хмарного телефона.
- **Передумови**: хмарний телефон повинен бути увімкнений і не може бути зайнятий іншим учасником команди.
- **Ефект**: служба спершу обходить батьківський каталог і лише потім починає передачу, тому неіснуючий шлях призводить до помилки **тут**, а не під час опитування статусу. Ціль має бути звичайним файлом, а не каталогом.
- **Завершення**: **прийнято, але не завершено.** Відповідь повертає `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)