createProjectTask（创建云转存任务）

createProjectTask：创建云转存任务

要点：https://openapi.lechange.cn/openapi/createProjectTask · 见错误码

根据设备序列号、转录类型、时间区间等，创建录像转录任务生成MP4转录文件

请求参数

参数名	参数类型	是否必填	默认值	合法值	参数说明
token	String	是			管理员 accessToken
projectId	String	是		非负整数字符串（≥0），如 `"1"`	项目id
deviceId	String	是			设备序列号
channelId	string	是			通道号
taskType	Integer	是		1或2	任务类型，1本地录像，2云存储
beginTime	string	是		需早于当前时间，beginTime和endTime相差不能超过24小时	开始时间，yyyy-MM-dd HH:mm:ss
endTime	string	是		需早于当前时间，beginTime和endTime相差不能超过24小时	结束时间，yyyy-MM-dd HH:mm:ss
combine	Integer	是		0或1	是否合并，0否，1是
sliceTime	Integer	是		30-180	切片时长，单位分钟（30-180）
multipleSpeed	Integer	否	1	1或2。1-正常速度；2-以2倍速转录，降低转录任务耗时	倍速转录选项，当前本地录像转录时生效。注意：不同设备性能有差异，如果2倍速转录生成文件出现丢帧等异常现象，建议切回正常1倍速转录
password	String	否		如果设备开启音视频密码，需加密传输该参数，具体加密详细说明请见下文	设备密码加密后的字符串

password加密算法详细说明：
password计算值的公式为：Base64(AES256_CBC(sourcePassword，key[]，iv[]))；
加密规则如下：
1、采用CBC分组加密的方式，算法为AES/CBC/PKCS5Padding；
2、sourcePassword为设备的明文密码；
3、key[]为密钥（key）的二进制数组；
4、密钥（key）为：LowerCase(MD5(UpperCase(Base64(KDF(deviceId,MD5(appsecret))))))，KDF算法为PBKDF2WithHmacSHA256，迭代1200次，导出密钥长度256；
5、iv[]为初始化向量的二进制数组，为：MD5(appSecret)，采用Java自带的MessageDigest的MD5算法加密。

请求示例

{
    "system":{
        "ver":"1.0",
        "appId":"lcdxxxxxxxxx",
        "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
        "time":1603366491,
        "nonce":"7aed0429-1a92-4a51-b8b0-cfebb60dcc85"
    },
    "id":"a25f887f-33f0-44ef-9ed3-f60f83193482",
    "params":{
        "token": "<yourAccessToken>",
        "projectId": "XX",
        "deviceId": "123456789xxx",
        "channelId": "0",
        "taskType": 2,
        "beginTime": "2022-11-09 21:00:00",
        "endTime": "2022-11-09 21:12:00",
        "combine": 1,
        "sliceTime": 30,
        "multipleSpeed": 1,
        "password": "Drky7ViI6amHA5ePT3QebA=="
    }
}

响应字段

字段名		字段类型	字段说明
taskId		String	任务Id

响应示例

{
    "result": {
        "msg": "操作成功。",
        "code": "0",
        "data": {
            "taskId": "XXX"
        }
    },
    "id":"a25f887f-33f0-44ef-9ed3-f60f83193482"
}

错误码

本接口可能返回下列码；完整分组见错误码。

网关与鉴权（SN / TK / OP）

错误码	错误码说明	下一步
`SN1001`	签名异常	按签名核对 `sign`
`TK1002`	token 无效或过期	重新获取 token
`OP1002`	缺少必填参数	补必填字段
`OP1003`	参数不合法	按本页参数表核对
`OP1039`	分钟级限流	等到下一分钟再试
`OP1040`	调用超限	降低频率
`DV1007`	设备离线或超时	等设备上线

子账号（SUB）

错误码	错误码说明	下一步
`SUB1001`	子账号无指定权限	在子账号策略中补权限
`SUB1002`	子账号无任何设备权限	授权设备或调整策略
`SUB1005`	子账号 token 过期	重新获取子账号 token
`SUB1006`	子账号与设备无授权关系	核对 `Resource` 与设备序列号
`SUB1008`	子账号未绑定当前应用	先创建并绑定子账号
`SUB1007`	创建子账号失败	核对参数后重试
`SUB1009`	子账号创建失败，账号格式错误	`account` 须为手机号或邮箱
`SUB1010`	子账号创建失败，账号已存在	勿重复绑定同一子账号到应用

更多见错误码 · SUB。

设备访问与通道（DV10xx）

错误码	错误码说明	下一步
`DV1007`	设备离线或超时	等设备上线；低电休眠先唤醒
`DV1009`	设备正忙	稍后重试
`DV1012`	分享/授权设备权限不足	核对子账号 `Permission` / `Resource`
`DV1019`	能力集不支持	确认型号与设备能力
`DV1020`	通道离线	检查通道与设备状态
`DV1026`	不支持此功能	换接口或升级固件
`DV1028`	未绑定或通道不存在	核对 `deviceId` / `channelId`
`DV1030`	设备休眠	唤醒后再调
`DV1057`	通道不存在	核对通道号
`DV1061`	设备响应超时	检查设备网络
`DV1062`	需先唤醒设备	调用唤醒接口
`DV1069`	不满足操作条件	见 `msg`

云转存（VT）

错误码	错误码说明	下一步
`VT1001`	账户下无该项目	核对 `projectId` 或先 createProject
`VT1002`	删除项目时仍有执行中任务（`taskStatus=3`）	先 stopProjectTask 或待任务结束
`VT1003`	删除项目时仍有未过期文件	先 deleteProjectTaskFileByFileId 或待过期
`VT1004`	无该文件或文件不属于当前用户	核对 `fileId`
`VT1005`	文件下载地址已过期	重新查询文件详情获取新地址
`VT1006`	时间段内无可录内容	调整任务时间区间
`VT1007`	无该任务	核对 `taskId`
`VT1008`	任务当前状态不可终止	核对 `taskStatus`
`VT1009`	混合云应用不支持平台下载/删除	换非混合云场景或联系支持

更多见错误码（VT 分组）。

余额（OP）

错误码	错误码说明	下一步
`OP2017`	开发者账号余额不足	充值后重试

说明

须使用管理员 accessToken。子账号 token 应在网关/鉴权层拒绝（见 SUB）；各服务内子账号校验以实现为准。