LoRa管理API接口
新增终端
说明:motelist值要转换成字符串。使用该接口前请先添加对应的通用终端设备。
URL接口格式
https://xxxx:xx/iot/loraurl/addMotes
请求方式
POST
请求参数
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
motelist | [String] | 是 | 终端配置列表 |
scenarioID | Number | 是 | 场所ID |
motelist:
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
moteEUI | String | 是 | 终端唯一标识,IEEE64格式,16进制字符串, "010203040506070809" |
classMode | String | 否 | 终端模式A/B/C,默认为A |
mode | Number | 是 | 配置方式,0:OTAA,1:ABP |
appKey | String | 否 | APP应用key,mode=0时必须指定,并与终端版本appKey对应,形式为16进制的IEEE64格式字符串 "2B7E151628AED2A6ABF7158809CF4F3C" |
rptPeriod | Number | 否 | 上报周期 最小值10(单位:S),默认60S |
devAddr | String | 否 | 终端IP地址 mode=1时必须指定,x.x.x.x格式 |
nwkSKey | String | 否 | 网络加密秘钥,mode=1指定,并与终端版本appSKey对应,形式为16进制IEEE64格式字符串 "2B7e151628AED2A6ABF7158809CF4F3C" |
appSKey | String | 否 | 应用加密秘钥,mode=0指定,并与终端版本nwkSKey对应,形式为16进制IEEE64格式字符串 "2B7e151628AED2A6ABF7158809CF4F3C" |
desc | String | 否 | 支持中文,最长64字节 |
packetType | Number | 否 | 终端数据报文类型 1 : confirmed 0 : unconfirmed |
ADR | Number | 否 | 默认开启 1: on 0: off |
RX1DRoffset | Number | 否 | 接收窗口RX1速率偏移,范围[0-5] |
RX2DR | Number | 否 | 接收窗口RX2速率,范围[0-5] |
RX1delay | Number | 否 | RX1延迟时间,范围[0-15] |
Ch4Freq | Number | 否 | 信道4频率,EU433频段专用,如433.375MHz |
Ch4DrRange | Number | 否 | 信道4可用速率范围,EU433频段专用,UINT8类型,高4位为最大允许速率,低4位为最小允许速率 |
Ch5Freq | Number | 否 | 信道5频率 ,同信道4配置 |
Ch5DrRange | Number | 否 | 信道5可用速率范围,同信道4配置 |
Ch6Freq | Number | 否 | 信道6频率,同信道4配置 |
Ch6DrRange | Number | 否 | 信道6可用速率范围,同信道4配置 |
Ch7Freq | Number | 否 | 信道7频率,同信道4配置 |
Ch7DrRange | Number | 否 | 信道7可用速率范围,同信道4配置 |
Ch8Freq | Number | 否 | 信道8频率,同信道4配置 |
Ch8DrRange | Number | 否 | 信道8可用速率范围,同信道4配置 |
maxdcycle | Number | 否 | 最大占空比基数,范围[0-15],EU433默认用7,CN470默认用0 |
RX2Freq | Number | 否 | RX2频率,EU433范围[433.175-434.665]MHz,保留3位小数;CN470范围[500.3-509.7]MHz,b保留1位小数,如434.665MHz/505.3MHz |
TXDR | Number | 否 | 终端报文发送速率DR值,EU433范围[0-7],CN470范围[0-5] |
TXPower | Number | 否 | EU433可选[10,7,4,1,-2,-5],CN470可选[17,16,14,12, 10,7,5,2],该字段值填充以上数组值对应的下标,即EU433可填范围[0-5],CN470可填范围[0-7] |
ChMask | Number | 否 | 可用信道掩码,EU433为16进制字符串,如0x0F;CN470为二进制字符串,长度为96 |
NbRep | Number | 否 | Unconfirmed报文重传次数,默认为1 |
AdrAckLimit | Number | 否 | unconfirmed报文不置ADRACKReq标记位报文个数,范围[1-15] |
AdrAckDelay | Number | 否 | unconfirmed报文置ADRACKReq标记位报文个数,范围[0-15] |
long | Number | 否 | 经度位置 |
lati | Number | 否 | 纬度未知 |
location | String | 否 | 由经纬度决定的位置信息,必须与经纬度同时存在 |
devType | String | 是 | 终端型号,新华三终端一律使用IN4500-L ,支持中文,长度不超过8 |
band | Number | 否 | 终端工作频段433/470,默认470 |
tmnName | String | 是 | 终端名称,与通用终端管理一致,字符串,最多32个字符 |
accessWay | String | 是 | 内嵌模组,值有internet/embed/serial,一般终端选择internet即可,embed为模组选项 |
请求结果
{
"status": 0,
"errMsg": "添加终端失败"
}
错误码说明
status | 1(成功) | 0(失败) | |
---|---|---|---|
errMsg | null | 用户名不合法 | 用户名长度为32 |
无效的场景ID | 范围为0-0xFFFFFF的UINT整数 | ||
当前会话已更新,请关闭该窗口 | Cookie老化,或者场景ID与用户不匹配 | ||
应用不存在 | 场景下未添加该应用 | ||
终端EUI不合法 | devEUI/moteEUI不符合规范 | ||
添加终端失败 | 未知错误 | ||
工作频段设置不合法 | band属性填充不符合规范 | ||
窗口2频率设置无效 | RX2Freq字段不符合规范 | ||
终端模式不合法 | classMode属性不合法,只能填字符'A'、'B'、'C' | ||
入网模式不合法 | mode属性不合法,只能填UINT整型的0跟1 | ||
应用密钥不合法 | appKey属性值不符合规范 | ||
应用SKey或网络SKey不合法 | 两者在mode=1时指定,且要符合格式要求 | ||
终端地址不合法 | mode=1时要指定且要符合IP地址的格式要求 | ||
接收窗口参数不合法 | RX1DRoffset、RX2DR或RX2Freq属性值不合法 | ||
窗口1时延不合法 | RX1delay属性值不合法 | ||
占空比设置不合法 | maxdcycle属性值不合法 | ||
上报间隔设置不合法 | rptPeriod属性值不合法 | ||
速率自适应开关不合法 | ADR开关不合法 | ||
信道设置不合法 | TXDR、TXPower、NbRep、ChMask不合法,如果是EU433终端,还可能是信道4、5、6、7、8的频率与速率范围不合法 | ||
报文类型不合法 | packetType属性值不合法,UINT整型0/1 | ||
地理位置信息不合法 | 经纬度与location不合法 | ||
名称不合法 | 终端名称不合法,长度不超过64字节 | ||
描述信息不合法 | desc属性不合法 | ||
包含未知参数 | 有多余的参数 | ||
添加生效终端失败 | mode=1时专有错误 | ||
终端已存在 | 该终端已添加 | ||
终端型号不合法 | devType不合法,注意长度限制 | ||
终端不存在 | 对应的通用终端没有添加 |
请求示例
https://xxxx:xx/iot/loraul/addMotes
body:
{
"scenarioID": 10000,
"motelist": [
{"moteEUI": "0000000000000001", "mode": 0, "appKey": "2B7e151628AED2A6ABF7158809CF4F3C"},
{"moteEUI": "0000000000000002", "mode": 1, "appSKey": "2B7e151628AED2A6ABF7158809CF4F3C",
"classMode": "C", "nwkSKey": "2B7e151628AED2A6ABF7158809CF4F3C", "tmnName": "h3c"}]
}
删除终端
说明:motelist值要转换成字符串。
URL接口格式
https://xxxx:xx/iot/loraurl/delMotes
请求方式
POST
请求参数
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
motelist | [String] | 是 | 对象数组 |
scenarioID | Number | 是 | 场所ID |
motelist:
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
moteEUI | String | 是 | 终端唯一标识,IEEE64格式,16进制字符串 "1122334455667788" |
请求结果
{
"status": 0,
"errMsg": "删除终端失败"
}
错误码说明
status | 1(成功) | 0(失败) | |
---|---|---|---|
errMsg | null | 用户名不合法 | 用户名长度为32 |
无效的场景ID | 范围为0-0xFFFFFF的UINT整数 | ||
应用不存在 | 场景下未添加该应用 | ||
终端不存在 | 用户场景下不存在该终端 | ||
终端EUI或应用EUI不合法 | devEUI/moteEUI不符合规范 | ||
删除终端失败 | 未知错误 | ||
删除生效终端失败 | 未知错误 |
请求示例
https://xxxx:xx/iot/loraurl/delMotes
body:
{
"scenarioID": 10000,
"motelist": [
{"moteEUI":"0000000000000003"},
{"moteEUI":"0000000000000002"}]
}
修改终端
说明:motelist值要转换成字符串。
URL接口格式
https://xxxx:xx/iot/loraurl/modifyMotes
请求方式
POST
请求参数
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
motelist | [String] | 是 | 更新终端数组 |
scenarioID | Number | 是 | 场所ID |
motelist:
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
moteEUI | String | 是 | 终端唯一标识,IEEE64格式,16进制字符串, "010203040506070809" |
classMode | String | 否 | 终端模式A/B/C,默认为A |
mode | Number | 是 | 配置方式,0:OTAA,1:ABP |
appKey | String | 否 | APP应用key,mode=0时必须指定,并与终端版本appKey对应,形式为16进制的IEEE64格式字符串 "2B7E151628AED2A6ABF7158809CF4F3C" |
rptPeriod | Number | 否 | 上报周期 最小值10(单位:S),默认60S |
devAddr | String | 否 | 终端IP地址 mode=1时必须指定,x.x.x.x格式 |
nwkSKey | String | 否 | 网络加密秘钥,mode=1指定,并与终端版本appSKey对应,形式为16进制IEEE64格式字符串 "2B7e151628AED2A6ABF7158809CF4F3C" |
appSKey | String | 否 | 应用加密秘钥,mode=0指定,并与终端版本nwkSKey对应,形式为16进制IEEE64格式字符串 "2B7e151628AED2A6ABF7158809CF4F3C" |
desc | String | 否 | 支持中文,最长64字节 |
packetType | Number | 否 | 终端数据报文类型 1 : confirmed 0 : unconfirmed |
ADR | Number | 否 | 默认开启 1: on 0: off |
RX1DRoffset | Number | 否 | 接收窗口RX1速率偏移,范围[0-5] |
RX2DR | Number | 否 | 接收窗口RX2速率,范围[0-5] |
RX1delay | Number | 否 | RX1延迟时间,范围[0-15] |
Ch4Freq | Number | 否 | 信道4频率,EU433频段专用,如433.375MHz |
Ch4DrRange | Number | 否 | 信道4可用速率范围,EU433频段专用,UINT8类型,高4位为最大允许速率,低4位为最小允许速率 |
Ch5Freq | Number | 否 | 信道5频率 ,同信道4配置 |
Ch5DrRange | Number | 否 | 信道5可用速率范围,同信道4配置 |
Ch6Freq | Number | 否 | 信道6频率,同信道4配置 |
Ch6DrRange | Number | 否 | 信道6可用速率范围,同信道4配置 |
Ch7Freq | Number | 否 | 信道7频率,同信道4配置 |
Ch7DrRange | Number | 否 | 信道7可用速率范围,同信道4配置 |
Ch8Freq | Number | 否 | 信道8频率,同信道4配置 |
Ch8DrRange | Number | 否 | 信道8可用速率范围,同信道4配置 |
maxdcycle | Number | 否 | 最大占空比基数,范围[0-15],EU433默认用7,CN470默认用0 |
RX2Freq | Number | 否 | RX2频率,EU433范围[433.175-434.665]MHz,保留3位小数;CN470范围[500.3-509.7]MHz,b保留1位小数,如434.665MHz/505.3MHz |
TXDR | Number | 否 | 终端报文发送速率DR值,EU433范围[0-7],CN470范围[0-5] |
TXPower | Number | 否 | EU433可选[10,7,4,1,-2,-5],CN470可选[17,16,14,12, 10,7,5,2],该字段值填充以上数组值对应的下标,即EU433可填范围[0-5],CN470可填范围[0-7] |
ChMask | Number | 否 | 可用信道掩码,EU433为16进制字符串,如0x0F;CN470为二进制字符串,长度为96 |
NbRep | Number | 否 | Unconfirmed报文重传次数,默认为1 |
AdrAckLimit | Number | 否 | unconfirmed报文不置ADRACKReq标记位报文个数,范围[1-15] |
AdrAckDelay | Number | 否 | unconfirmed报文置ADRACKReq标记位报文个数,范围[0-15] |
long | Number | 否 | 经度位置 |
lati | Number | 否 | 纬度未知 |
location | String | 否 | 由经纬度决定的位置信息,必须与经纬度同时存在 |
devType | String | 是 | 终端型号,新华三终端一律使用IN4500-L ,支持中文,长度不超过8 |
band | Number | 否 | 终端工作频段433/470,默认470 |
tmnName | String | 是 | 终端名称,与通用终端管理一致,字符串,最多32个字符 |
请求结果
{
"status": 0,
"errMsg": "修改终端失败"
}
错误码说明
status | 1(成功) | 0(失败) | |
---|---|---|---|
errMsg | null | 用户名不合法 | 用户名长度为32 |
无效的场景ID | 范围为0-0xFFFFFF的UINT整数 | ||
当前会话已更新,请关闭该窗口 | Cookie老化,或者场景ID与用户不匹配 | ||
应用不存在 | 场景下未添加该应用 | ||
终端EUI不合法 | devEUI/moteEUI不符合规范 | ||
修改终端失败 | 未知错误 | ||
工作频段设置不合法 | band属性填充不符合规范 | ||
窗口2频率设置无效 | RX2Freq字段不符合规范 | ||
终端模式不合法 | classMode属性不合法,只能填字符'A'、'B'、'C' | ||
入网模式不合法 | mode属性不合法,只能填UINT整型的0跟1 | ||
应用密钥不合法 | appKey属性值不符合规范 | ||
应用SKey或网络SKey不合法 | 两者在mode=1时指定,且要符合格式要求 | ||
终端地址不合法 | mode=1时要指定且要符合IP地址的格式要求 | ||
接收窗口参数不合法 | RX1DRoffset、RX2DR或RX2Freq属性值不合法 | ||
窗口1时延不合法 | RX1delay属性值不合法 | ||
占空比设置不合法 | maxdcycle属性值不合法 | ||
上报间隔设置不合法 | rptPeriod属性值不合法 | ||
速率自适应开关不合法 | ADR开关不合法 | ||
信道设置不合法 | TXDR、TXPower、NbRep、ChMask不合法,如果是EU433终端,还可能是信道4、5、6、7、8的频率与速率范围不合法 | ||
报文类型不合法 | packetType属性值不合法,UINT整型0/1 | ||
地理位置信息不合法 | 经纬度与location不合法 | ||
名称不合法 | 终端名称不合法,长度不超过64字节 | ||
描述信息不合法 | desc属性不合法 | ||
包含未知参数 | 有多余的参数 | ||
修改生效终端失败 | mode=1时专有错误 | ||
终端型号不合法 | devType不合法,注意长度限制 | ||
当前修改太频繁,请10s后重试 | 两次修改间隔过短 | ||
终端不存在 | 对应的通用终端没有添加 |
请求示例
https://xxxx/iot/loraurl/modifyMotes
body:
{
"scenarioID":10000,
"tmnName":"h3c",
"motelist":[
{"moteEUI": "0000000000000002", "band": 433, "Ch4Freq": 433.175, "Ch4DR": 80},
{"moteEUI": "0000000000000003", "band": 433, "Ch4Freq": 433.175, "Ch4DR": 80}]
}
新增网关
URL接口格式
https://xxxx:xx/iot/loraurl/addGW
请求方式
POST
请求参数
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
gwlist | [String] | 是 | 网关mac对象数组 |
scenarioID | Number | 是 | 场所ID |
gwlist:
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
alias | String | 是 | 网关设备别名,支持中文、字符、数字、下划线,最大32字节长 |
mac | String | 是 | 网关MAC ID IEEE64格式字符串,16字节长 |
devSN | String | 是 | 网关设备序列号,支持字符串、数字,最大32字节长 |
desc | String | 否 | 网关描述,支持中文、字符、数字、下划线,最大64字节长 |
long | Number | 否 | 网关经度信息 |
lati | Number | 否 | 网关纬度信息 |
location | String | 否 | 网关地理位置,与经纬度同时存在并对应,用户自己保证信息与经纬度对应 |
请求结果
{
"status": 0,
"errMsg": "新增网关失败"
}
错误码说明
status | 1(成功) | 0(失败) | |
---|---|---|---|
errMsg | null | 用户名不合法 | 用户名长度为32 |
无效的场景ID | 范围为0-0xFFFFFF的UINT整数 | ||
当前会话已更新,请关闭该窗口 | Cookie老化,或者场景ID与用户不匹配 | ||
网关ID不合法 | mac属性不合法 | ||
网关设备序列号不合法 | devSN不合法 | ||
名称不合法 | 设备别名不合法 | ||
描述信息不合法 | desc属性值不合法 | ||
地理位置信息不合法 | desc属性值不合法 | ||
网关已存在,请检查网关ID与设备序列号 | mac或者devSN已被占用 | ||
添加网关失败 | 未知错误 |
请求示例
https://xxxx/iot/loraurl/addGW
body:
{
"scenarioID": 10000,
"gwlist": [
{"mac": "6600000000000001", "alias": "网关1", "devSN": "DEVSN1123456"},
{"mac": "6600000000000002", "alias": "网关2", "devSN": "DEVSN1123456777",
"long": 10.124, "lati": "10.102", "location": "浙江省杭州市滨江区"}]
}
删除网关
URL接口格式
https://xxxx:xx/iot/loraurl/delGW
请求方式
POST
请求参数
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
gwlist | [String] | 是 | 待删除的网关对象数组 |
scenarioID | Number | 是 | 场所ID |
gwlist:
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
mac | String | 是 | 网关mac |
devSN | String | 是 | 设备序列号 |
请求结果
{
"status": 0,
"errMsg": "删除网关失败"
}
错误码说明
status | 1(成功) | 0(失败) | |
---|---|---|---|
errMsg | null | 用户名不合法 | 用户名长度为32 |
无效的场景ID | 范围为0-0xFFFFFF的UINT整数 | ||
当前会话已更新,请关闭该窗口 | Cookie老化,或者场景ID与用户不匹配 | ||
网关ID不合法 | mac属性不合法 | ||
网关不存在 | 用户场景下无该网关 | ||
删除网关失败 | 未知错误 |
请求示例
https://192.168.110.15:9094/lora/delGW
body :
{
"scenarioID": 10000,
"gwlist": [
{"mac": "6000000000000001", "devSN": "1122112211221122"},
{"mac": "6000000000000002", "devSN": "1122112211221123"}]
}
更新网关
URL接口格式
http://xxxx:xx/iot/loraurl/modifyGW
请求方式
POST
请求参数
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
mac | String | 是 | 网关MAC地址 |
desc | String | 否 | 描述 |
long | Number | 否 | 网关经度位置 |
lati | Number | 否 | 网关纬度位置 |
location | String | 否 | 网关位置,与经纬度对应,且同时存在 |
alias | String | 是 | 设备别名 |
scenarioID | Number | 是 | 场所ID |
devSN | String | 是 | 设备序列号 |
请求结果
{
"status": 0,
"errMsg": "删除网关失败"
}
错误码说明
status | 1(成功) | 0(失败) | |
---|---|---|---|
errMsg | null | 用户名不合法 | 用户名长度为32 |
无效的场景ID | 范围为0-0xFFFFFF的UINT整数 | ||
当前会话已更新,请关闭该窗口 | Cookie老化,或者场景ID与用户不匹配 | ||
网关ID不合法 | mac属性不合法 | ||
网关不存在 | 用户场景下无该网关 | ||
更新网关失败 | 未知错误 |
请求示例
http://xxxx:xx/iot/loraurl/modifyGW
body :
{
"alias": "h3c",
"devSN": "219801A1D30000011111",
"mac": "6000000000000001",
"long": 10.012,
"lati": "20.132",
"location": "浙江省杭州市滨江区"
}
获取终端地理位置信息
说明:该接口用于获取用户(当前场景)所有终端所在位置信息。该接口为分批获取接口。若不携带skip(跳过的符合条件的信息条数)与maxCount (当前要获取的最大条数)信息,接口将返回前1000条信息。
URL接口格式
https://xxxx:xx/iot/loraurl/getCreateMoteLocation?skip=0&maxCount=100&scenarioID=1000
请求方式
GET
返回结果参数说明
返回值参数 | 类型 | 说明 |
---|---|---|
total | Number | 本次终端总数 |
list | [moteObj,moteObj...] | 终端位置对象数组 |
moteObj:
返回值参数 | 类型 | 说明 |
---|---|---|
devEUI | String | 设备EUI |
long | Number | 经度 |
lati | Number | 纬度 |
location | String | 终端地理位置 |
请求示例
https://xxxx:xx/iot/loraurl/getCreateMoteLocation?skip=0&maxCount=100&scenarioID=1000
请求结果
{
"status": 1,
"errMsg": null,
"data": {
"total": 100,
"list": [
{"mac": "0211111111111111", "lati":20, "long": 30, "location": "杭州"},
{"mac": "0211111111111112", "lati":20, "long": 30, "location": "杭州"}]
}
}
请求错误码说明
status | 1(成功) | 0(失败) | |
---|---|---|---|
errMsg | null | 用户名不合法 | 用户名长度为32 |
无效的场景ID | 范围为0-0xFFFFFF的UINT整数 | ||
当前会话已更新,请关闭该窗口 | Cookie老化,或者场景ID与用户不匹配 | ||
查询异常 | 未知错误 |
获取网关地理位置信息
说明:该接口用于获取用户(当前场景)所有终端所在位置信息。该接口为分批获取接口。若不携带skip(跳过的符合条件的信息条数)与maxCount (当前要获取的最大条数)信息,接口将返回前1000条信息。
URL接口格式
https://xxxx:xx/iot/loraurl/getCreateGatewayLocation?skip=0&maxCount=100&scenarioID=10000
请求方式
GET
返回结果参数说明
返回值参数 | 类型 | 说明 |
---|---|---|
total | Number | 本次网关总数 |
list | [GwObj,GwObj...] | 对象数组 |
GwObj:
返回值参数 | 类型 | 说明 |
---|---|---|
mac | String | 网关MAC |
long | Number | 经度 |
lati | Number | 纬度 |
location | String | 网关地理位置 |
请求示例
https://xxxx:xx/iot/loraurl/getCreateGatewayLocation?skip=0&maxCount=100&scenarioID=10000
请求结果
{
"status": 1,
"errMsg": null,
"data": {
"total": 100,
"list": [
{"mac": "0211111111111111", "lati": 20, "long": 30, "location": "杭州"},
{"mac": "0211111111111112", "lati": 20, "long": 30, "location": "杭州"}]
}
}
请求错误码说明
status | 1(成功) | 0(失败) | |
---|---|---|---|
errMsg | null | 用户名不合法 | 用户名长度为32 |
无效的场景ID | 范围为0-0xFFFFFF的UINT整数 | ||
当前会话已更新,请关闭该窗口 | Cookie老化,或者场景ID与用户不匹配 | ||
查询异常 | 未知错误 |
获取指定用户下网关列表
说明:获取用户(当前场景)网关列表,支持分页获取功能,如果没有分页参数,将返回前100条数据
URL接口格式
https://xxxx:xx/iot/loraurl/getGwListByOwner?page=0&pageSize=50&scenarioID=10000 https://xxxx:xx//iot/loraurl/getGwListByOwner?scenarioID=10000
请求方式
GET
返回结果参数说明
返回值参数 | 类型 | 说明 |
---|---|---|
list | [{gwObj}...] | 用户列表数组 |
page | Number | 页码 |
total | Number | 用户(当前场景)网关总数 |
gwObj:
返回值参数 | 类型 | 说明 |
---|---|---|
alias | String | 设备别名 |
mac | String | 网关ID |
devSN | String | 设备序列号 |
long | Number | 网关经度位置 |
lati | Number | 网关纬度位置 |
location | String | 网关地理位置,与经纬度对应 |
desc | String | 描述信息 |
time | String | 创建时间 |
请求示例
https://xxxx:xx/iot/loraurl/getGwListByOwner?page=1&pageSize=50&scenarioID=1000
请求结果
{
"status": 1,
"errMsg": null,
"data": {
"page": 1,
"total": 2,
"list": [
{"mac": "1122112211221122", "desc": "hangzhou", "alias": "gw1", "devSN": "1111AAAA"},
{"mac": "1122112211221155", "desc": "hangzhou1", "alias": "gw", "devSN": "2222AAAA"}]
}
}
请求错误码说明
status | 1(成功) | 0(失败) | |
---|---|---|---|
errMsg | null | 用户名不合法 | 用户名长度为32 |
无效的场景ID | 范围为0-0xFFFFFF的UINT整数 | ||
当前会话已更新,请关闭该窗口 | Cookie老化,或者场景ID与用户不匹配 | ||
查询异常 | 未知错误 |
获取在线网关
说明:获取用户(当前场景)已连接的网关信息
URL接口格式
https://xxxx:xx/iot/loraurl/getActiveGWs?scenarioID=10000
请求方式
GET
返回结果参数说明
返回值参数 | 类型 | 说明 |
---|---|---|
list | [{obj},{obj}...] | 在线网关列表 |
total | Number | 在线网关总数 |
list:
返回值参数 | 类型 | 说明 |
---|---|---|
gwmac | String | 网关ID |
time | String | 网关上一次报文上送时间 |
alias | String | 设备别名 |
请求示例
https://xxxx:xx/iot/loraurl/getActiveGWs?scenarioID=10000
请求结果
{
"Status": 1,
"errMsg": null,
"data": {
"total": 2,
"list": [
{"gwmac": "1122112211221122", "time": "2017-07-21 19:20:21"},
{"gwmac": "1122112211221133", "time": "2017-07-21 19:21:21"}]
}
}
请求错误码说明
status | 1(成功) | 0(失败) | |
---|---|---|---|
errMsg | null | 用户名不合法 | 用户名长度为32 |
无效的场景ID | 范围为0-0xFFFFFF的UINT整数 | ||
当前会话已更新,请关闭该窗口 | Cookie老化,或者场景ID与用户不匹配 | ||
查询异常 | 未知错误 |
获取在线终端
说明:获取用户(当前场景)已接入服务器的终端
URL接口格式
https://xxxx:xx/iot/loraurl/getActiveMotes?scenarioID=10000
请求方式
GET
返回结果参数说明
返回值参数 | 类型 | 说明 |
---|---|---|
list | [{obj},{obj}...] | 在线终端列表 |
total | Number | 在线终端数 |
list:
返回值参数 | 类型 | 说明 |
---|---|---|
devEUI | String | 终端EUI |
gwmac | String | 最近一次报文上报通过的网关ID |
time | String | 最近一次报文上报的时间 |
freq | Number | 最近一次报文上报的频率 |
coding | String | 最近一次报文上报的编码率 |
datr | String | 最近一次报文上报的速率与带宽 |
devAddr | String | 终端分配到的地址 |
devName | String | 终端名称 |
请求示例
https://xxxx:xx/iot/loraurl/getActiveMotes?scenarioID=10000
请求结果
{
"Status": 1,
"errMsg": null,
"data": {
"total": 1,
"list": [{
"devEUI": "1122112211221122",
"gwmac": "6666666666666666",
"freq": 470.3,
"datr": "SF7BW125",
"codding": "4/5"}]
}
}
请求错误码说明
status | 1(成功) | 0(失败) | |
---|---|---|---|
errMsg | null | ||
无效的场景ID | 范围为0-0xFFFFFF的UINT整数 | ||
当前会话已更新,请关闭该窗口 | Cookie老化,或者场景ID与用户不匹配 | ||
查询异常 | 未知错误 |
获取指定网关下的在线终端
说明:该接口用于获取指定近期通过指定网关上报数据的在线终端信息
URL接口格式
https://xxxx:xx/iot/loraurl/getActiveMotesGroupByGw?mac=0000000000000001&scenarioID=10000
请求方式
GET
返回结果参数说明
返回值参数 | 类型 | 说明 |
---|---|---|
list | [{obj},{obj}...] | 在线终端列表 |
total | Number | 在线终端数 |
list:
返回值参数 | 类型 | 说明 |
---|---|---|
devEUI | String | 终端EUI |
time | String | 最近一次报文上报的时间 |
freq | Number | 最近一次报文上报的频率 |
coding | String | 最近一次报文上报的编码率 |
datr | String | 最近一次报文上报的速率与带宽 |
devAddr | String | 终端分配到的地址 |
请求示例
https://xxxx:xx/iot/loraurl/getActiveMotesGroupByGw?mac=0000000000000001&scenarioID=10000
请求结果
{
"status": 1,
"errMsg": null,
"data": {
"total": 1,
"list": [{
"devEUI": "1122112211221122",
"gwmac": "6666666666666666",
"freq": 470.3,
"datr": "SF7BW125",
"codding": "4/5"}]
}
}
请求错误码说明
status | 1(成功) | 0(失败) | |
---|---|---|---|
errMsg | null | ||
用户名不合法 | 用户名长度为32 | ||
无效的场景ID | 范围为0-0xFFFFFF的UINT整数 | ||
当前会话已更新,请关闭该窗口 | Cookie老化,或者场景ID与用户不匹配 | ||
网关ID不合法 | gwmac不符合规范 | ||
查询异常 | 未知错误 |