跳到主要内容
版本:3.4.0

查询录像上传状态

GET /strm/stored/upload

本接口用于查询录像上传请求的完成状态。有两种查询模式:

  • 按请求ID查询,此时只需要提供reqId参数
  • 按开始时间的范围查询(即查询startTimeStart <= startTime < startTimeEnd的记录),此时需要提供startTimeStart, startTimeEnd两个参数,同时要指定__page__limit两个分页参数,可选提供simNo参数。

请求

GET https://n11.gratour.info:7011/v1/strm/stored/upload?reqId=RDfKroT1Q7uew4LOXrkS5A
X-Auth-Token: HrWwReOAQ9WdLnJQ1JYivA

查询参数

参数数据类型必要说明
reqIdstringY?上传远程录像接口 POST /strm/stored/upload 返回的请求ID
startTimeStartstringY?录像的开始时间的范围起始时间,格式:yyyy-MM-dd HH:mm:ss
startTimeEndstringY?录像的开始时间的范围结束时间,格式:yyyy-MM-dd HH:mm:ss
simNostring终端识别号

注:reqId和(startTimeStart, startTimeEnd)两者必要其一

应答

{
"data": [
{
"reqId": "RDfKroT1Q7uew4LOXrkS5A",
"simNo": "13320200317",
"channel": 1,
"startTime": "2020-04-06 23:52:09",
"endTime": "2020-04-06 23:54:13",
"almState": "0",
"mediaType": 0,
"codeStrm": 1,
"storageType": 1,
"st": 3,
"fileSz": 3982099,
"path": "/2020/04/13320200317/1_20200406235209_20200406235413_011",
"fileName": "ch1_200408192717_200408193230.avi",
"uploadTm": "2020-04-07 13:21:08",
"url": "http://gratour.info/v1/fs/avres/2020/04/13320200317/1_20200406235209_20200406235413_011/ch1_200408192717_200408193230.avi"
}
],
"count": 1,
"errCode": 0,
"message": "成功。"
}

应答实体属性

属性数据类型必要说明
errCodeintY错误码。
  • 如果设备不在线,将返回错误码:-27
messagestringY错误信息
dataarray[AvUpload]返回的结果对象数组。元素为AvUpload类型,见下
countint返回的记录数

AvUpload

属性数据类型必要说明
reqIdstringY上传请求ID
reqTmstringY最后一次请求时间
simNostringY终端识别号
channelintY音视频逻辑通道号。参见JT/T 1078标准定义的车载视频逻辑通道号定义表
startTimestringY录像文件的开始记录时间,格式:yyyy-MM-dd HH:mm:ss
endTimestringY录像文件的结束记录时间,格式:yyyy-MM-dd HH:mm:ss
almStatestringY64位报警标志,以16进制值表示,如:A0表示十进制的160,二进制的10100000。位0-31定义请参考JT/T 808-2011表18报警标志位定义;位32-63定义请参考JT/T 1078-2016表14视频报警报警标志位定义。
mediaTypeintY音视频资源类型:
  • 0: 音、视频
  • 1: 音频
  • 2: 视频
  • 3: 视频或音频
codeStreamintY码流类型:
  • 0: 所有码流
  • 1: 主码流
  • 2: 子码流
未指定时默认为0
storageTypeintY存储位置:
  • 0: 所有存储位置
  • 1: 主存储器
  • 2: 灾备存储器
未指定时默认为0
fileSzbigintY文件大小,字节数
stintY当前上传状态:
  • 1: 请求已创建
  • 2: 终端已经应答
  • 3: 上传中
  • 4: 上传已完成
  • 5: 失败
  • 6: 已经取消
  • 7:超时
fileNamestring文件名,未完成上传时无此属性,或为null
uploadTmstring上传完成时间,格式:yyyy-MM-dd HH:mm:ss。未完成上传时无此属性,或为null
urlstring已上传文件的下载URL,未完成上传时无此属性,或为null