Skip to content

Push a Public URL File to Cloud Phones (Async) ​

Downloads a file from a public HTTP(S) URL and asynchronously pushes it to cloud phones in the current tenant. The destination must be a full path under /sdcard/. The platform does not register the file as a tenant file; the device node validates the public connection and redirects, limits file size, and checks the downloaded SHA-256 against the written content.

Interface Address:

text
/papi/file/push-url

Request Method:

text
POST

Content-Type:

text
application/json

Header Parameters:

ParameterTypeRequiredDescription
X-Access-KeystringYesAPI access key ID; see API Rules
X-SignaturestringYesBase64-encoded HMAC-SHA256 signature
X-TimestampstringYesUnix timestamp in milliseconds (13 digits)
X-NoncestringYesRandom string of 10–32 lowercase letters and digits

Body Parameters:

ParameterTypeRequiredDescription
ctrIdListarray[string]YesCloud phone IDs in the current tenant
urlstringYesPublic HTTP(S) file URL
destinationstringYesFull destination file path under /sdcard/

Request Example:

json
{
  "ctrIdList": [
    "a9147f4f2039ce0e76ff835aa6c1527ac9d366d4f6c5dcbe273616bc64be031b"
  ],
  "url": "https://example.com/demo.jpg",
  "destination": "/sdcard/Download/demo.jpg"
}

Response Parameters:

ParameterTypeDescription
codeintegerError code; see Error Codes
dataobjectOperation result
├─ successbooleanWhether the operation succeeded
├─ taskIdstringAsynchronous task ID
├─ dataobjectAdditional data
├─ msgstringOperation message
├─ ctrIdstringCloud phone ID
├─ ctrAliasstringCloud phone alias
├─ ctrSlotintegerCloud phone slot
msgstringError message

Response Example:

json
{
  "code": 0,
  "data": {
    "success": false,
    "taskId": "",
    "data": {},
    "msg": "",
    "ctrId": "",
    "ctrAlias": "",
    "ctrSlot": 0
  },
  "msg": ""
}
Copyright © 2026 HongKong Quantity Best Technology Limited

QTPhone Help Center