03、查询设备信息

3.1 功能概述

  正常情况下，设备产生的数据将会由平台通过【06、设备信息定时推送】接口主动推送给绑定的商户。

  查询设备信息接口提供额外的设备信息查询服务，可以查询最近一次的设备缓存数据。

3.2 请求地址：

    http://iot.znskiot.com:6208/tags

3.3 信息依赖

  同步返回信息，不依赖异平台推送。

3.4 HTTP 请求方式

  POST

3.5 返回格式

  JSON

3.6 请求参数

参数名称 参数类型 是否必须 描述
action String 是 参数取值为："query"
payload String 是 携带参数：masterid|activekey|deviceid|type

payload参数说明

masterid、activekey、deviceid、type与前面的接口中payload参数对应字段功能和取值一致。

3.7 请求示例

RF 耳标数据查询：

    curl -d "action=query&payload=1001|OGMzYmNiMz1586904179|1000062|0" http://iot.znskiot.com:6208/tags

3.8 服务响应

请求成功时服务器同步返回下面的JSON格式结果。

{
    "action":"query",
    "payload":"msgseq|deviceid|type|gatewayid|battery|temperature|envtemperature|lng|lat|closingflag|damage|rssi|intervals|update",
    "error":"error_code"
}

action 参数说明

 action 与请求时的topic参数一致，为 "query"

payload 参数说明

 msgseq 为消息序号

 deviceid、type 与请求中payload参数相关字段一致

 gatewayid

  为网关编号。没有网关的直连设备取值为0，设备未产生上行数据时取值为 0

 其它数据字段含义如下：

字段名称 含义 / 功能描述 备注
battery 电池电量 小数，例如 3.20
temperature 设备温度（目标体温） 小数，例如 37.60
envtemperature 环境温度 小数，例如 22.30
lng 设备GPS经度坐标 小数，例如 114.066105
lat 设备GPS纬度坐标 小数，例如 22.549458
closingflag 合盖状态 0 合盖；
1 开盖
damage 拆盒盖次数 整数
rssi 标签信号 0 信号正常；
1 信号弱或信号异常；
负值 为实际信号强度（单位dBm）；
intervals 数据上报时间间隔 单位分钟，例如 30
update 数据上报时间戳 Unix时间戳，例如 1616494664

关于设备位置信息说明

  1、如果设备是没有网关的直连设备，设备位置为设备自身的位置信息；

  2、如果设备是通过网关连接的非直连设备，设备位置为网关的位置信息；

  3、如果设备GPS经度坐标和纬度坐标都为 0.0 ，则该设备不支持定位；

error 参数说明

 error 参数的 error_code 为错误的响应码，参照【附录一：错误的响应码】相关说明

results matching ""

    No results matching ""