Fazer upload do arquivo para URL

Referência da API

Fazer upload do arquivo para URL

Request

Registra um arquivo já enviado para que o Cloud Phone o baixe.

Pré-requisitos: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe, e o objeto já precisa existir na URL. Envios para transmissão ao vivo precisam ser MP4 e ter como destino um serviço que suporte transmissão.
Conclusão: aceito, não concluído. A resposta retorna fileId com status em andamento; consulte /api/cloudphone/upload/file/result.
Observação sobre a superfície: é a mesma implementação de /cloudphone/uploadFile na Open API. Não confunda com o fluxo multipart mais antigo /api/cloudphone/uploadFile desta superfície.

Erros de negócio documentados: 33401, 33419. Consulte Error Codes para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

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"
}