Загрузите файл по URL-адресу

Справочник API

Загрузите файл по URL-адресу

Request

Регистрирует ранее загруженный файл, чтобы облачный телефон его скачал.

Предварительные условия: облачный телефон должен быть включён и не должен быть занят другим участником команды, и объект уже должен существовать по указанному URL. Загрузки для прямой трансляции должны быть в MP4 и предназначаться Сервису, поддерживающему трансляции.
Завершение: принято, но не завершено. Ответ возвращает fileId со статусом «в процессе»; опрашивайте /api/cloudphone/upload/file/result.
Примечание о поверхности API: это та же реализация, что и /cloudphone/uploadFile в Open API. Не путайте с более старым multipart-сценарием /api/cloudphone/uploadFile на этой же поверхности.

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

Bodyapplication/jsonrequired

idstringrequired

Cloud phone ID

urlstringrequired

Upload url, which can be the link returned by the cloudphone/upload/file/signedURL interface or other publicly accessible file download address

uploadDeststringrequired

Storage directory

uploadTypeinteger

File type (1 = regular file, 2 = MP4 live-streaming file)

Default:1

Enum:12

curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/upload/file \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://example-bucket.s3.amazonaws.com/prod/cloudPhoneOpenApi/1666625111121936/20260901/demo.mp4",
    "id": "1666625111121936",
    "uploadDest": "/Download",
    "uploadType": 2
  }'

Responses

Success. data is an object with the fields id, fileId and status.

Headers

any

Bodyapplication/json

codeintegerrequired

Response code, 0 indicates success,>0 indicates failure

msgstring or nullrequired

dataobjectrequired

requestIdstringrequired

Response

{
  "code": 0,
  "msg": null,
  "data": {
    "id": "1666625111121936",
    "fileId": "10069435",
    "status": 0
  },
  "requestId": "e5d69c5e2d364106a0715dab1d9a03d3"
}