Skip to content

公网 URL 异步推送文件到云手机 ​

从公网 HTTP(S) URL 下载文件并异步推送到当前租户的云机。目标须为 /sdcard/ 下的完整文件路径。平台不登记租户文件;节点会验证公网连接及每次跳转、限制文件大小,并核对下载内容与写入内容的 SHA-256。

接口地址:

text
/papi/file/push-url

请求方式:

text
POST

请求数据类型:

text
application/json

Header 参数:

参数类型必填说明
X-Access-Keystring是API 访问密钥 ID,鉴权方式见 接口规则
X-Signaturestring是签名值,Base64 编码的 HMAC-SHA256 计算结果
X-Timestampstring是毫秒级 Unix 时间戳(13 位)
X-Noncestring是随机字符串,10~32 位小写字母+数字

Body 参数:

参数类型必填说明
ctrIdListarray[string]是当前租户的云机 ID 列表
urlstring是公网 HTTP(S) 文件 URL
destinationstring是/sdcard/ 下完整的目标文件路径

请求示例:

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

响应参数:

参数类型说明
codeinteger错误码,参见 错误码说明
dataobject操作结果
├─ successboolean操作是否成功
├─ taskIdstring异步任务 ID
├─ dataobject附加数据
├─ msgstring当前操作消息
├─ ctrIdstring云机 ID
├─ ctrAliasstring云机别称
├─ ctrSlotinteger云机槽位
msgstring错误提示

响应示例:

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

QTPhone 帮助中心