跳到主要内容
版本：3.4.4

在线终端查询集成接口

GET /online_terms

提供者: Micro-GNSS

调用者: 企业应用

Micro-GNSS调用本接口，并将返回的信息供调试工具使用。

请求​

GET /online_terms?__page=1&__limit=50

查询参数​

属性数据类型必要说明
simNostring所要查询的终端的识别号。不指定本参数时，查询所有在线终端1
__pageint分页查询的第几页。1为第1页。仅当未指定simNo时有效2
__limitint分页查询的每页记录数。仅当未指定simNo时有效2
注1：企业应用可以选择只实现按 `simNo` 查询单个终端的在线信息，而当查询不指定 `simNo` 时，返回空的结果集。
注2：如果查询参数中未指定 `simNo` 参数，则 `__page` 和 `__limit` 参数为必要参数。

应答​

{
  "data": [
    {
      "simNo": "13305306661",
      "protoVer": 1,
      "acc": false,
      "spd": 0.0
    },
    {
      "simNo": "18108942480",
      "protoVer": 1,
      "acc": true,
      "spd": 0.0
    },
    {
      "simNo": "18003232026",
      "protoVer": 1,
      "acc": false,
      "spd": 0.0
    }
  ],
  "count": 3,
  "errCode": 0,
  "message": "成功。"
}

应答实体属性​

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

OnlineTerm​

属性数据类型必要说明
simNostringY终端识别号
protoVerint终端的JT808协议版本号
  • 0: 2013版本
  • 1: 2019版本
如果网关不能提供此数据，可不返回此属性
accboolean终端是否处于ACC ON的状态。如果网关不能提供此数据，可不返回此属性
spdfloat终端当前的GPS速度，单位：km/h。如果网关不能提供此数据，可不返回此属性