跳到主要内容
版本:1.1.7

下发终端指令集成接口

POST /term_cmd

提供者: 企业应用

调用者: Micro-GNSS

注:本接口地址可配置。

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

指令所属协议指令消息号指令名称必要
JT/T 8088201查询位置信息可选 1
JT/T 10789101音视频传输请求必要
JT/T 10789102音视频实时传输控制必要
JT/T 10789201远程录像回放请求必要
JT/T 10789202远程录像回放控制必要
JT/T 10789205查询资源列表可选 2
JT/T 10789206录像文件上传指令可选 3
JT/T 10789207录像文件上传控制可选 3
T/GDRTA, T/SCSDX, T/JSATL等9208报警附件上传指令可选 4
JT/T 10789301云台旋转可选 5
JT/T 10789302云台调整焦距控制可选 5
JT/T 10789303云台调整光圈控制可选 5
JT/T 10789304云台雨刷控制可选 5
JT/T 10789305红外补光控制可选 5
JT/T 10789306云台变倍控制可选 5
1: 此指令用于调试工具程序( https://n11.gratour.info:3001/ )检查终端是否在线,可选实现。
2: 不实现时,接口[`GET /strm/stored`](../../http-api/av-upload-api/qry-stored-av)将不可用,企业应用应另行提供接口供客户端调用。

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

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

请求

POST /term_cmd
Content-Type: application/json

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

请求实体属性

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

应答

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

应答实体属性

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