nbiot电信云北向开发---基于LiteNAdemo_https例程

本文将借助于官方的例程实现nbiot的定位功能。

 

一.功能分析

1.数据上报

当bc20上报数据时，电信云平台能够将数据自动推送到后台服务器。（目前暂时由后台服务器发送请求，自动推送需要ca证书）

 

 

（1）鉴权

电信云采用token来保障安全。使用对应的appid和secret获取token。调用其他接口时需要附上token。

请求示例：

Method: POST

request:

https://server:port/iocm/app/sec/v1.1.0/login

Content-Type:application/x-www-form-urlencoded

Body:

{

appId=******,

secret=******

}

响应示例：

response:

Status Code: 200 OK

Content-Type: application/json

Body:

{

"scope": "default",

"tokenType": "bearer",

"expiresIn": "*******",

"accessToken": "*******",

"refreshToken": "*******"

}

使用官方例程，修改对应的appid和secret，运行，得到如下结果

 

（2)后台服务器向电信云平台请求数据

请求示例：

Method: GET

request:

https://server:port/iocm/app/dm/v1.4.0/devices/{deviceId}?select=imsi

Header:

"app_key: **"

"Authorization:Bearer**"

Content-Type:application/json

响应示例：

response:

Status Code: 200 OK

Content-Type: application/json

Body:

{

"deviceId": "xxxxx",

"gatewayId": "xxxxx",

"nodeType": "xxxxx",

"deviceInfo": {

"name": "Sensor_12",

"manufacturerName": "wulian",

"deviceType": "gateway",

"model": "90",

"mac": "C7EA1904004B1204",

"swVersion": "th",

"fwVersion": "seu",

"hwVersion": "sru",

"protocolType": "zigbee",

"description": "smockdetector",

"imsi": "xxxxx"

},

"services": [

{

"serviceType": "air_conditioner",

"serviceId": "1",

"data"{

"battery_low": 1

}

},

{

"serviceType": "air_conditioner",

"serviceId": "jkh",

"data": {

"battery_low": "jhj"

}

}

]

}

修改例程的相关参数，运行结果如下

 

 

2.命令下发

后台服务器可以将命令下发到bc20设备，当设备不在线的时候命令缓存在电信云平台。

Method: POST

request: https://server:port/iocm/app/cmd/v1.4.0/deviceCommands

Header:

"app_key: ******"

"Authorization:Bearer******"

Content-Type:application/json

Body:

{

"deviceId": "********",

"command": {

"serviceId": "********",

"method": "********",

"paras": {

"paraName1": "paraValue1",

"paraName2": "paraValue2"

}

},

"callbackUrl": "http://127.0.0.1:9999/cmd/callbackUrl",

"maxRetransmit":******,

}

响应示例

response:

Status Code: 201 OK

Content-Type:application/json

Body:

{

"commandId": "********",

"appId": "********",

"deviceId": "********",

"command": {

"serviceId": "********",

"method": "********",

"paras": {

"paraName1": "paraValue1",

"paraName2": "paraValue2"

}

},

"callbackUrl": "http://127.0.0.1:9999/cmd/callbackUrl",

"expireTime": null,

"status": "PENDDING",

"creationTime": "20170222T164000Z",

"executeTime": null,

"platformIssuedTime": null,

"deliveredTime": null,

"issuedTimes": null,

"maxRetransmit":******

}

修改相关参数，运行结果如下

设备接收到相关信息

 

 

 

 

 

3.可以通过后台服务器在电信云平台注册设备

当需要添加新设备的时候，可以通过后台服务器向电信云平台注册。

 

请求示例

Method: POST

request:

https://server:port/iocm/app/reg/v1.1.0/deviceCredentials?appId=*********

Header:

"app_key: ******"

"Authorization:Bearer ******"

Content-Type:application/json

Body:

{

"endUserId": "***********",

"verifyCode": "****************",

"nodeId": "****************",

"psk": "********************************",

"timeout": 300,

}

响应示例

response:

Status Code: 200 OK

Content-Type: application/json

Body:

{

"deviceId": "*******",

"verifyCode": "*******",

"psk": "*********",

"timeout": 300

}

最上一行的设备就是刚才注册的。

 

也可以删除设备