如果你的应用需要整合tr069来管理你的设备,可以使用http api来管理。
测试注意事项:
1)登录到TR069云平台后查看当前用户的Open API Token,下面所有HTTP URL中的apitoken中的值需要修改为自己用户的值
2)设备需要按照首页的说明上报到TR069平台,如果你的设备在私网,可以把上报周期调小。
3)如果需要配置比如WAN,SIP,VOIP,LAN等参数可以使用下面的api进行推送,注意后面的 apitoken的值需要更好自己用户的.
比如为一台设备配置多个参数,比如配置sip的用户名与密码
HTTP URL: http://39.106.195.193:8888/api/task/setParameterValues?apitoken=561b5dad96784401853d9ddb8cde2c63
HTTP 方法:POST
输入数据:
[
{
"params": [
{
"name": "InternetGatewayDevice.Services.VoiceService.1.VoiceProfile.1.Line.1.SIP.AuthUserName",
"type": "string",
"value": "abc124"
},
{
"name": "InternetGatewayDevice.Services.VoiceService.1.VoiceProfile.1.Line.1.SIP.AuthPassword",
"type": "string",
"value": "test23424"
}
],
"serialNumber": "simTestSerial"
}
]
返回数据:
{
"resCode": "8200",
"data": {
"failedRequestCpes": [],
"successRequestCpes": [
{
"serialNumber": "simTestSerial",
"msg": "ACS收到配置请求"
}
],
"requestToken": "53F381ED2C754648B5B65D306B4C8AEE", //这个返回的token可以查询设备的配置结果
"totalRequestCpes": "1"
},
"resMessage": "操作成功!"
}
api调用参考如下:
配置参数接口
url完整格式:http://39.106.195.193:8888/api/task/setParameterValues?apitoken=561b5dad96784401853d9ddb8cde2c63
请求URL
api/task/setParameterValues
POST
请求体 application/json
[{ "serialNumber":"string //设备序列号", "params":[{ "name":"string //参数名称", "value":"string //参数值", "type":"string //参数值" }] }]
返回结果
{ "resCode":"string", "data":{ "failedRequestCpes":[{ "serialNumber":"string //设备序列号", "msg":"string //消息" }], "successRequestCpes":[{ "serialNumber":"string //设备序列号", "msg":"string //消息" }], "requestToken":"string //配置任务生成的唯一token,可以用这个token查询该任务执行的结果", "totalRequestCpes":"string //待处理的设备总数" } }
添加实例接口
url完整格式:http://39.106.195.193:8888/api/task/addObject?apitoken=561b5dad96784401853d9ddb8cde2c63
请求URL
api/task/addObject
POST
请求体 application/json
[{ "serialNumber":"string //设备序列号", "params":"string[] //实例参数节点,节点参数最后以.结束,例如:InternetGatewayDevice.WANDevice.1.WANConnectionDevice.5." }]
返回结果
{ "resCode":"string", "data":{ "failedRequestCpes":[{ "serialNumber":"string //设备序列号", "msg":"string //消息" }], "successRequestCpes":[{ "serialNumber":"string //设备序列号", "msg":"string //消息" }], "requestToken":"string //配置任务生成的唯一token,可以用这个token查询该任务执行的结果", "totalRequestCpes":"string //待处理的设备总数" } }
设备重启 支持同时重启多台设备
url完整格式:http://39.106.195.193:8888/api/task/reboot?apitoken=561b5dad96784401853d9ddb8cde2c63
请求URL
api/task/reboot
POST
请求体 application/json
[{ "serialNumber":"string //设备序列号" }]
返回结果
{ "resCode":"string", "data":{ "failedRequestCpes":[{ "serialNumber":"string //设备序列号", "msg":"string //消息" }], "successRequestCpes":[{ "serialNumber":"string //设备序列号", "msg":"string //消息" }], "requestToken":"string //配置任务生成的唯一token,可以用这个token查询该任务执行的结果", "totalRequestCpes":"string //待处理的设备总数" } }
恢复出厂设置 支持同时处理多台设备
url完整格式:http://39.106.195.193:8888/api/task/factoryReset?apitoken=561b5dad96784401853d9ddb8cde2c63
请求URL
api/task/factoryReset
POST
请求体 application/json
[{ "serialNumber":"string //设备序列号" }]
返回结果
{ "resCode":"string", "data":{ "failedRequestCpes":[{ "serialNumber":"string //设备序列号", "msg":"string //消息" }], "successRequestCpes":[{ "serialNumber":"string //设备序列号", "msg":"string //消息" }], "requestToken":"string //配置任务生成的唯一token,可以用这个token查询该任务执行的结果", "totalRequestCpes":"string //待处理的设备总数" } }
设备固件升级 支持多台设备进行固件升级
url完整格式:http://39.106.195.193:8888/api/task/firmwareUpgrade?apitoken=561b5dad96784401853d9ddb8cde2c63
请求URL
api/task/firmwareUpgrade
POST
请求体 application/json
{ "serialNumbers":"string[] //设备序列号", "firmware":{ "downloadUrl":"string //下载固件URL", "downloadUserName":"string //下载用户名", "downloadPassword":"string //下载密码", "downloadFileName":"string //下载文件名称", "downloadFileSize":"string //下载文件大小" }, "name":"string", "scheduleTime":"string //计划升级时间" }
返回结果
{ "resCode":"string", "data":"boolean" }
请求URL
api/task/query
GET
请求参数 application/x-www-form-urlencoded
参数名 | 类型 | 必须 | 描述 |
---|---|---|---|
requestToken | string | 否 |
返回结果
{ "resCode":"string", "data":[{ "serialNumber":"string //设备序列号", "params":[{ "name":"string //TR069参数节点", "value":"string //TR069参数值", "type":"string //TR069参数类型", "status":"string //下发状态", "msg":"string //消息", "executeTime":"date //执行时间" }] }] }