桌面端：云录像上传状态查询

云录像上传状态

2025/12/03新增

1，在开始上传录像时，调用一次本接口，参数示例为下

开始录像阶段，还没有文件相关的信息，不传，新增一个status=-1代表开始录像了，返回值不用处理。


{
  "cc_ent_id": 96939,
  "cc_user_id": 86036022,
  "fastcode": "",
  "rc_ent_id": 0,
  "rc_user_id": 0,
  "remote_id": 1484588335,
  "seq_num": 0,
  "seq_start_time": 1764741250,
  "sid": 1764741246990989,
  "status": -1, // 表示正在录像中
}

// 返回
{}

2，文件录制完毕，准备上传（现状，无变动）

与录像中状态的区别在于，已经有了录像文件，需要传文件和时间等信息，status为0（0可不传），此逻辑兼容线上，不用修改。

{
  "cc_ent_id": 96939,
  "cc_user_id": 86036022,
  "fastcode": "",
  "file_rawsize": 186785,
  "file_sha256": "7D428054DE8CD13B0DDAE1DA48B389F41D39F9769B7740D53FA875F070F7EDCD",
  "rc_ent_id": 0,
  "rc_user_id": 0,
  "remote_id": 1484588335,
  "seq_end_time": 1764741257,
  "seq_num": 0,
  "seq_start_time": 1764741250,
  "sid": 1764741246990989
}

其他

断点续传的时候，查询偏移量。
查询当前上传的方式。

腾讯云 cos 的临时秘钥上传参考 https://cloud.tencent.com/document/product/436/14048 中的使用临时密钥访问 COS的java样例
cos sdk的 c++ 上传文档 https://cloud.tencent.com/document/product/436/35161

UploadOffsetCheckError = "video/upload_offset_check_error" // 上传的offset参数校验错误
UploadStatusCacheNotFound = "video/upload_status_cache_not_found" // 没找到对应的 status 缓存信息
UploadFileSizeCheckError = "video/uploadsize_check_error" // req.UploadSize+req.UploadOffset> req.FileRawsize 或者真实文件大小和 upload_size 不一样
UploadSaveFileError = "video/upload_savefile_error" // 文件写入失败了
ErrorStatusSetCache = "video/status_set_cache_error" // status写入cache失败
UploadSha256CheckError = "video/upload_sha256_check_error" // 上传后 sha256校验失败
UploadStatusCheckFailed = "video/status_check_failed" // sataus缓存校验过程中的其他错误
UploadServerUnknowError = "video/server_check_error_retry_please" // 文件校验出错，清理文件和缓存重新走status流程上传
CloudRecordingNotOpen = "video/cloud_recording_not_open" // 云录像没有开启
DEPS_CLOUDRECORDCONFIG_GET_FAILD = "deps/cloudrecording_get_faild" // 云录像配置获取错误
DEPS_FASTCODE_GET_FAILD = "deps/fastcode_get_faild" // fastcode交换出错了

DepsUserSvcGetFailed = "video/deps_usersvc_get_failed" // 获取用户服务信息失败了
DepsEnterpriseSvcGetFailed = "video/deps_enterprisesvc_get_failed" // 获取企业＋服务信息失败了
DepsEnterpriseSvcGetUserDepartmentsFailed = "video/deps_get_user_departments_failed" // 获取用户部门信息失败
DepsTagSvcGetRemoteTagsFailed = "video/deps_get_remote_tags_failed" // 获取设备分组信息失败

UserSvcFeatureNotMatched = "video/usersvc_feature_not_matched" // 用户服务配件不匹配
CloudRecordingNotOpen = "video/cloud_recording_not_open" // 云录像没有开启
UserSvcServiceExpired = "video/usersvc_service_expired" // 用户服务已经过期
CloudRecordingUserNotAllowed = "video/user_not_allowed" // 主控用户不允许上传
CloudRecordingRemoteNotAllowed = "video/remote_not_allowed" // 被控设备部允许上传

application/json

Body

示例

向日葵存储返回样例（SaaS）自定义存储返回示例（SaaS）向日葵存储-初次返回示例（私有化）向日葵存储-断点续传返回示例（私有化）异常示例异常示例

{
    "upload_url": "https://sunlogin-video.oss-cn-hangzhou.aliyuncs.com",
    "upload_type": 2,
    "oss_signature": {
        "OSSAccessKeyId": "LTAI5t5owzQFFZA634E8UYYR",
        "upload_url": "https://sunlogin-video.oss-cn-hangzhou.aliyuncs.com",
        "policy": "eyJleHBpcmF0aW9uIjoiMjAyMy0wNi0xNVQwODoxMzoxNVoiLCJjb25kaXRpb25zIjpbWyJzdGFydHMtd2l0aCIsIiRrZXkiLCJ2aWRlby8xLzEvNDQ0LzMzMy8xMjM0NTY3ODkwMTIzIl1dfQ==",
        "signature": "Q2pV4L0d+ISNaGH6pj0Il3tTbvo=",
        "expire": 1686816795,
        "callback": "eyJjYWxsYmFja1VybCI6Imh0dHBzOi8vaDY4ODU4NzlkLnlpY3AuZnVuL3ZpZGVvL2NhbGxiYWNrIiwiY2FsbGJhY2tCb2R5Ijoie1widHlwZVwiOlwib3NzXCIsXCJmaWxlbmFtZVwiOiR7b2JqZWN0fSxcInNpemVcIjogJHtzaXplfSxcIm1pbWVUeXBlXCI6JHttaW1lVHlwZX0sXCJyZW1vdGVfaWRcIjoyMjIsXCJyY191c2VyX2lkXCI6MzMzLFwiY2NfdXNlcl9pZFwiOjEsXCJyY19lbnRfaWRcIjo0NDQsXCJjY19lbnRfaWRcIjoxLFwic2lkXCI6MTIzNDU2Nzg5MDEyMyxcInNlcV9udW1cIjowLFwic2VxX3N0YXJ0X3RpbWVcIjoxNjg2MjA1ODM1LFwic2VxX2VuZF90aW1lXCI6MTY4NjIwNjg0OSxcImZpbGVfc2hhMjU2XCI6XCJlNzM3ZmNlODg1NjI2YmY3OWJlYTcxNzhiNmY0YzIzM2NmMTE5YzJiNjgxMjUyZDEyYmM3ZGNmZDE4NzlkMTExXCJ9IiwiY2FsbGJhY2tCb2R5VHlwZSI6ImFwcGxpY2F0aW9uL2pzb24ifQ==",
        "dir": "video/1/1/444/333/1234567890123",
        "key": "video/1/1/444/333/1234567890123/0_1234567890123_1686205835_1686206849_e737fce885626bf79bea7178b6f4c233cf119c2b681252d12bc7dcfd1879d111.mp4"
    }
}

桌面端：云录像上传状态查询

云录像上传状态

其他

请求参数

请求示例代码

返回响应

桌面端：云录像上传状态查询

云录像上传状态#

其他#

请求参数

请求示例代码

返回响应

云录像上传状态

其他