下发终端指令集成接口

POST /term_cmd

提供者: 企业应用

调用者: Micro-GNSS

注：本接口地址可配置。

当采用网关对接方式时，企业应用提供本接口，由Micro-GNSS调用本接口请求企业应用的终端网关向终端下发以下指令：

指令所属协议	指令消息号	指令名称	必要
JT/T 808	8201	查询位置信息	可选 1
JT/T 1078	9101	音视频传输请求	必要
JT/T 1078	9102	音视频实时传输控制	必要
JT/T 1078	9201	远程录像回放请求	必要
JT/T 1078	9202	远程录像回放控制	必要
JT/T 1078	9205	查询资源列表	可选 2
JT/T 1078	9206	录像文件上传指令	可选 3
JT/T 1078	9207	录像文件上传控制	可选 3
T/GDRTA, T/SCSDX, T/JSATL等	9208	报警附件上传指令	可选 4
JT/T 1078	9301	云台旋转	可选 5
JT/T 1078	9302	云台调整焦距控制	可选 5
JT/T 1078	9303	云台调整光圈控制	可选 5
JT/T 1078	9304	云台雨刷控制	可选 5
JT/T 1078	9305	红外补光控制	可选 5
JT/T 1078	9306	云台变倍控制	可选 5

注¹: 此指令用于调试工具程序( https://n11.gratour.info:3001/ )检查终端是否在线，可选实现。
注²: 不实现时，接口[`GET /strm/stored`](../../http-api/av-upload-api/qry-stored-av)将不可用，企业应用应另行提供接口供客户端调用。

注³: 不实现时，接口POST /strm/stored/upload、POST /strm/stored/upload/ctrl将不可用，接口GET /strm/stored/upload将返回空结果， 企业应用应另行提供接口供客户端调用。
注⁴: 不实现时，报警附件提取功能将不可用，企业应用应另行提供接口供客户端调用。
注⁵: 不实现时，指令接口POST /term_cmd对应的指令将不可用，企业应用应另行提供接口供客户端调用。

企业应用可根据自己的实际需求，选择实现部分或全部指令。

请求

POST /term_cmd
Content-Type: application/json

{
  "msgId": "8201",
  "simNo": "13320200317"  
}

请求实体属性

属性	数据类型	必要	说明
msgId	string	Y	JT/T 808，JT/T 1078 指令消息号，如位置信息查询指令为：8201
subCmdTyp	string		子命令类型。如终端控制的大类型是8105，子命令类型是它的命令字。又如下发终端升级包，大类型是8108，子命令是它的升级类型。
simNo	string	Y	终端识别号
params	object		参数，以 JSON 对象表示。参考终端指令参数属性。
timeout	int		超时时长，单位：秒。不指定时或指定为0时，指令将在半小时后超时。小于2的非0值无效。

应答

{
  "data": [
    {
      "id": "410950043",
      "reqTm": 1576031206415,
      "status": 0,
      "simNo": "13320200317",
      "msgId": "8201",
      "msgSn": 1289
    }
  ],
  "count": 1,
  "errCode": 0,
  "message": "成功。"
}

应答实体属性

属性	数据类型	必要	说明
errCode	int	Y	错误码。 如果终端不在线，返回错误码-27 如果设备应答不在线，返回错误码：-27 如果长时间未能打开流，返回错误码：-5 服务端发生异常时，返回错误码：-2 其它错误，如设备连上随即断开连接，返回错误码：-3
message	string	Y	错误信息
data	array[TermCmd]		返回的结果对象数组。元素为 TermCmd 类型。主要使用其中的id属性
count	int		返回的记录数