Перейти к содержимому
Справочник API
/
Облачные телефоны
/
/Files

Загрузка файлов

Request

Загружает локальный файл напрямую на облачный телефон (устаревший multipart-сценарий).

  • Предварительные условия: облачный телефон должен быть включён и не должен быть занят другим участником команды. Код загрузки, полученный на шаге предподписанного URL, одноразовый.
  • Завершение: ответ лишь подтверждает, что Local API принял передачу. Ни идентификатор задачи, ни опрашиваемое состояние не предоставляются, поэтому наблюдать за прогрессом невозможно.
  • Используйте вместо этого: /api/cloudphone/upload/file/signedUrl → PUT → /api/cloudphone/upload/file → /api/cloudphone/upload/file/result, когда нужен наблюдаемый прогресс и обработка повторов.
  • Примечание: этот путь — не та же операция, что /cloudphone/uploadFile в Open API, который регистрирует уже загруженный объект.

Задокументированные бизнес-ошибки: 33401, 33419. Значения кодов см. в Error Codes. Любая операция может дополнительно вернуть общие коды.

Bodymultipart/form-datarequired
idstringrequired

Cloud phone ID

Example:"1661515884160372"
filestring, (binary)required

File to upload

Example:"file://D:\\application\\apifox\\LICENSE.electron.txt"
uploadDeststringrequired

Upload destination directory

Example:"/Download"
curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/uploadFile \
  -H 'Content-Type: multipart/form-data' \
  -F id=1661515884160372 \
  -F 'file=file://D:\application\apifox\LICENSE.electron.txt' \
  -F uploadDest=/Download

Responses

The Local API accepted the direct upload and returns an empty JSON object.

Bodyapplication/json
object, <= 0 properties
Response
{}