Skip to content
API Reference
/
/
/
Request File Download URL

Request File Download URL

Request

Download a file from a Cloud Phone.

  • Preconditions: the phone must be powered on and not held by another member.
  • Effect: the service scans the parent directory first and only then starts the transfer, so a missing path fails here rather than on the status poll. It must match a regular file, not a directory.
  • Completion: accepted, not complete. The response returns downId; poll /cloudphone/download/result until the status is succeeded, failed or cancelled. The status endpoint re-checks that the phone is still powered on and still yours.
  • Retry: not idempotent — each call rescans and issues a new downId.

Documented business errors: 33300, 33301, 33507. See Error Codes for what each code means. Any operation can additionally return the common codes.

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