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

Справочник API

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

Request

Скачивает файл с облачного телефона.

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

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

Bodyapplication/jsonrequired

idstringrequired

Cloud phone ID

filePathstringrequired

file path: /sdcard/Download/a.txt

curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/download \
  -H 'Content-Type: application/json' \
  -d '{
    "filePath": "/sdcard/Download/report.csv",
    "id": "1661515884160372"
  }'

Responses

Success. data is an object with the fields id and downId.

Headers

any

Bodyapplication/json

codeintegerrequired

Response code, 0 indicates success,>0 indicates failure

msgstring or nullrequired

dataobjectrequired

requestIdstringrequired

Response

{
  "code": 0,
  "msg": "",
  "data": {
    "id": "1661515884160372",
    "downId": "1661515884160999"
  },
  "requestId": "7dcf166a597842139af5ce12d25fe0f8"
}