Завантажте файл для 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"
}