跳到主要内容
版本：3.4.2

查询录像文件上传活动状态

GET /strm/upload

本接口用于查询给定请求ID(reqId)指代的远程录像文件上传活动的状态。

注意：

本接口只能查询到仍处于等待终端上传或终端正在上传中的状态， 如果对应的上传活动已经结束，或已经超时、或已经注销，则查询将返回错误码 -8: 记录没有找到。

本接口可用于检查某个请求ID(reqId)对应的远程录像文件上传是否仍然处于活动中。

请求​

GET https://n11.gratour.info:7011/strm/upload?reqId=MPle4HuJnvMLDIJH
Authorization: Basic YWRtaW46YWRtaW4

查询参数​

参数数据类型必要说明
reqIdstringY所要查询的上传活动的reqId，此reqId由接口 POST /strm/upload 返回。

应答​

{
  "data": [
    {
      "reqId": "MPle4HuJnvMLDIJH",
      "simNo": "13320210317",
      "startTm": "2021-03-21 00:00:00",
      "sz": 3982099,
      "cb": "https://strm:PaEWWGCeE3Az9Z7o@n11.gratour.info:9100/v1",
      "st": 3,
      "uploaded": 1361794
    }
  ],
  "count": 1,
  "errCode": 0,
  "message": "成功。"
}

应答实体属性​

属性数据类型必要说明
errCodeintY错误码。
messagestringY错误信息。
dataarray[AvUploadStatus]返回的结果对象数组。元素为 AvUploadStatus 类型，见下。
countint返回的记录数。

AvUploadStatus​

属性数据类型必要说明
reqIdstringY远程录像文件上传请求ID。
simNostringY终端识别号。
startTmstringY录像文件的开始时间。格式：yyyy-MM-dd HH:mm:ss或yyyy-mm-ddTHH:mm:ssZ。使用前者格式时，时区默认为服务器时区。
szint注册时声明的远程录像文件的大小。
cbstringY远程录像文件上传相关的企业集成接口(SPI)的基地址。
stintY远程录像文件上传的状态，本查询只返回以下状态：
  • 1: 刚注册（终端上传尚未开始上传）
  • 3: 上传中
uploadedint已上传字节数。仅当 st 为 3 时出现本属性。