Tải xuống tập tin

Tài liệu tham khảo API

Tải xuống tập tin

Request

Tải một tệp từ cloud phone về.

Điều kiện tiên quyết: cloud phone phải đang bật và không bị thành viên khác chiếm giữ.
Tác động: dịch vụ quét thư mục cha trước rồi mới bắt đầu truyền, nên một đường dẫn không tồn tại sẽ thất bại ở bước này chứ không phải khi hỏi vòng trạng thái. Đích phải là một tệp thường, không phải thư mục.
Hoàn tất: đã tiếp nhận, chưa hoàn tất. Phản hồi trả về downId; hãy hỏi vòng /cloudphone/download/result cho đến khi trạng thái là thành công, thất bại hoặc đã hủy. Endpoint trạng thái đó kiểm tra lại rằng cloud phone vẫn đang bật và vẫn thuộc quyền chiếm giữ của bạn.
Thử lại: không idempotent — mỗi lần gọi đều quét lại và phát hành một downId mới.

Các mã lỗi nghiệp vụ đã ghi nhận: 33300, 33301, 33507. Xem Error Codes để biết ý nghĩa từng mã. Mọi thao tác cũng có thể trả về các mã dùng chung.

Security

Authorization

Bodyapplication/jsonrequired

idstringrequired

cloud phone id

filePathstringrequired

file path: /sdcard/Download/a.txt

curl -i -X POST \
  https://api.morelogin.com/cloudphone/download \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -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"
}