上传

接口说明

向指定设备上传安装包、图片或普通文件。

接口路径: /vmcloud/api/external/upload
请求类型: POST
内容类型: application/x-www-form-urlencoded

请求头

名称 必填 说明
x-ak 是 访问密钥 ID
x-timestamp 是 请求时间戳
x-sign 是 请求签名
x-merchant 是 商户名称
x-nonce 是 随机串

请求参数

参数 类型 必填 说明
uploadInfo object 是 上传信息
padCode string 是 设备编码
equipmentId string 是 设备 ID
supplierType string 是 设备类型
downloadUrl string 是 文件下载地址
fileName string 是 文件名
fileLength string 是 文件长度
fileType string 是 文件类型,2 安装包、3 图片、4 文件
md5 string 是 文件 MD5
apkInfo object 否 安装包解析信息
iconUrl string 否 安装包图标地址
packageName string 否 安装包包名
name string 否 安装包名称
versionCode string 否 安装包版本编码
versionName string 否 安装包版本名称

响应参数

参数 类型 说明
code number 错误码
msg string 错误内容描述
data string 上传结果

备注

当上传安装包时,可一并传递 apkInfo 相关字段,便于平台识别包信息。

请求示例

POST /vmcloud/api/external/upload
Content-Type: application/x-www-form-urlencoded
{
  "uploadInfo": {
    "padCode": "PAD001",
    "equipmentId": "10001",
    "supplierType": "android",
    "downloadUrl": "https://example.com/app.apk",
    "fileName": "app.apk",
    "fileLength": "1024",
    "fileType": "2",
    "md5": "abc123"
  }
}

响应示例

{
  "code": 0,
  "msg": "success",
  "data": "task_10001"
}