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-urlRequest Method:
text
POSTContent-Type:
text
application/jsonHeader Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| X-Access-Key | string | Yes | API access key ID; see API Rules |
| X-Signature | string | Yes | Base64-encoded HMAC-SHA256 signature |
| X-Timestamp | string | Yes | Unix timestamp in milliseconds (13 digits) |
| X-Nonce | string | Yes | Random string of 10–32 lowercase letters and digits |
Body Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| ctrIdList | array[string] | Yes | Cloud phone IDs in the current tenant |
| url | string | Yes | Public HTTP(S) file URL |
| destination | string | Yes | Full destination file path under /sdcard/ |
Request Example:
json
{
"ctrIdList": [
"a9147f4f2039ce0e76ff835aa6c1527ac9d366d4f6c5dcbe273616bc64be031b"
],
"url": "https://example.com/demo.jpg",
"destination": "/sdcard/Download/demo.jpg"
}Response Parameters:
| Parameter | Type | Description |
|---|---|---|
| code | integer | Error code; see Error Codes |
| data | object | Operation result |
| ├─ success | boolean | Whether the operation succeeded |
| ├─ taskId | string | Asynchronous task ID |
| ├─ data | object | Additional data |
| ├─ msg | string | Operation message |
| ├─ ctrId | string | Cloud phone ID |
| ├─ ctrAlias | string | Cloud phone alias |
| ├─ ctrSlot | integer | Cloud phone slot |
| msg | string | Error message |
Response Example:
json
{
"code": 0,
"data": {
"success": false,
"taskId": "",
"data": {},
"msg": "",
"ctrId": "",
"ctrAlias": "",
"ctrSlot": 0
},
"msg": ""
}