URL用のファイルをアップロードしてください

API リファレンス

Request

アップロード済みのファイルを登録し、クラウドフォンにダウンロードさせます。

前提条件：クラウドフォンが起動済みで、他のメンバーに占有されておらず、その URL にオブジェクトが既に存在していること。ライブ配信用のアップロードは MP4 でなければならず、配信に対応したデバイスサービスを対象にする必要があります。
完了シグナル：受理されただけで、完了ではありません。 レスポンスは処理中ステータスの fileId を返します。/api/cloudphone/upload/file/result をポーリングしてください。
API 面の補足：これは Open API の /cloudphone/uploadFile と同一の実装です。この面にある旧来の /api/cloudphone/uploadFile（multipart 方式）と混同しないでください。

文書化されたビジネスエラー: 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"
}