新版2015年fuhome协议

Size: px

Start display at page:

Download "新版2015年fuhome协议"

猛发卢
5 years ago
Views:

1 Fuhome 未来之家实验室 APP 开发者协议 HTTP 部分 v2.5.3 注意 :( ) 接口协议 : 便于扩展, 标注 H 为 16 进制值,D 为 10 进制值, 其他均为 ASCII 字符, 汉字编码 :UTF-8 Username: 用户名英文字母 + 字符 (@ _.)+ 中文 Userid: 与用户名一一对应的 10 位数字, 注册成功之后生成 Psw:md5 加密的 32 位小写密码 Openid: 开发者拥有的开发密钥, 成为开发者需要向管理员申请以下均举例说明, 不代表数据的真实和正确性, 只作为格式规范示例使用说明 :http 部分用 post 方式请求, 服务器回复均为 json 格式,UDP 部分 IP: : 注册或者登录, 成功之后返回 userid, 利用此作为后续请求标识 2 登录成功之后心跳包必须按要求维持 3 加载增加设备信息, 并显示头像 id 等 4 获取菜单, 传感器列表, 并指定控件进行触发, 显示等 5 利用 UDP 发送控制信息, 接受回复信息, 心跳状态量信息, 传感器信息等接口格式如此, 灵活选择利用即可, 谢谢持续建议更新!

2 HTTP 部分 : 0 手机首次注册验证 ( 频率不超过 1 分钟一次, 验证码有效时间 24 小时, 以最新为准 ) openid=d32ffbe0ce1e7dccf15483d978365a40&phonenum= &f=0&time= "dis":"f=0", "log":"ok" "dis":"f=0", // 号码已经注册 "dis":"f=0",, "phonenum":"used" 1 用户注册 openid=d32ffbe0ce1e7dccf15483d978365a40&username= &psw=4297f44b b d7a93&encode=641689&f=1&time= "dis":"f=1", "log":"ok"

3 "dis":"f=1",. "encode":"used"/"username":"used" 2 用户登录 ( 通用 ) openid=d32ffbe0ce1e7dccf15483d978365a40&username=lovelife&psw=4297f44b b d7a93&f=2&time= ( 微信用 ) openid=d32ffbe0ce1e7dccf15483d978365a40&username=fromusername&f=2&time= "dis":"f=2", "userid":" " "dis":"f=2", 3 添加认证设备 openid=d32ffbe0ce1e7dccf15483d978365a40&userid= &psw=4297f44b b d7a93& sbstr= abcedf0a&sbname= 办公室的灯 &f=3&time=

4 "dis":"f=3", "sbid":" ", "sbmm":"adf28d9b7a8d08b5", "sbname":" 办公室的灯 " "dis":"f=3", sbid: 设备 10 位 id SbMm: 设备 16 位加密密码 Sbname: 设备名字错误 : 串号错误或已经激活 4 增加普通 DIY 设备 openid=d32ffbe0ce1e7dccf15483d978365a40&userid= &psw=4297f44b b d7a93&sbname= 办公室的灯 &sjm=123456&f=4&time= "dis":"f=4", "sbid":" ", "sbmm":"adf28d9b7a8d08b5", "sbname":" 办公室的灯 "

5 "dis":"f=4", Sbname: 设备名字 Sjm: 设备明文密码, 位数 6-16, 系统会自动加密生成 16 位加密密码错误 : 资格数不够用 5 请求获取用户的设备列表 openid=d32ffbe0ce1e7dccf15483d978365a40&userid= &psw=4297f44b b d7a93&f=5&time= ( 微信用 ) openid=d32ffbe0ce1e7dccf15483d978365a40& userid= &username=fromusername&f=5&time= "dis":"f=5", "userid":" ", "c":"003", "sb":[ "shuxing":"00a","id":"10","sbid":" ","sbname":" 电饭锅 ","sbtime":" :00:07","sbadd":" 深圳市 ","statename":" 状态 ","statevalue":"open","imgurl":"3.jpg", "shuxing":"00a","id":"99","sbid":" ","sbname":" 电风扇 ","sbtime":" :00:07","sbadd":" 深圳市 ","statename":" 现状 ","statevalue":"open","imgurl":"5.png", "shuxing":"00a","id":"301","sbid":" ","sbname":" 热得快 ","sbtime":" :00:07","sbadd":" 深圳市 ","statename":" 在线 ON","statevalue":" 烧水中 ","imgurl":"10.jpg" ]

6 "dis":"f=5", PS. C: 设备总数 Shuxing: 暂无用 Id: 小 id 与 ID 一一对应 Sbid:ID,Sbname: 设备名字,sbtime: 最新活动时间 sbadd: 设备所在地址 Statename: 状态量名字 Statevalue: 状态量 ( 见设备端协议, 心跳包中所附带信息 ) Imgurl: 设备的大头贴, 完整路径 : 6 请求获取设备拥有的自定义菜单列表, 传感器列表 openid=d32ffbe0ce1e7dccf15483d978365a40&userid= &psw=4297f44b b d7a93&f=6&id=99&time= id: 上一条返回的信息中的 id(99 是电风扇的 id) "dis":"f=6", "userid":" ", "id":"99", "com":"003", "sbcom":[ "comname":" 热水器开 ","comsring":"open", "comname":" 热水器关 ","comsring":"close", "comname":" 热水器开 ","comsring":"open" ], "feel":"003", "sbfeel":[ "feelnum":"123","feelname":" 热水器 ","feelunit":" 度 ","feelstyle":"1", "feelnum":"123","feelname":" 发动机位置 ","feelunit":" 坐标 ","feelstyle":"2",

7 "feelnum":"123","feelname":" 空调 ","feelunit":" 湿度 ","feelstyle":"3" ] "dis":"f=6", Feelstyle: 传感器类型, 目前仅用 1 2,1 单值传感器,2GPS, 此处并不表示值的个数, 比如 3 可以定义为双值传感器, 具体定义随时根据网页说明更新 12 请求获取设备拥有的自定义菜单列表( 微信用, 以用户 userid 为标志 ) openid=d32ffbe0ce1e7dccf15483d978365a40&userid= &psw=4297f44b b d7a93&f=12&time= ( 微信用 ) openid=d32ffbe0ce1e7dccf15483d978365a40& userid= &username=fromusername&f=12&time= "dis":"f=12", "userid":" ", "com":"003", "sbcom":[ "comname":" 热水器开 ","comsring":"open", "comname":" 热水器关 ","comsring":"close", "comname":" 热水器开 ","comsring":"open" ]

8 "dis":"f=12", 15 请求获取设备拥有的所有传感器( 微信用, 以用户 userid 为标志 ) openid=d32ffbe0ce1e7dccf15483d978365a40&userid= &psw=4297f44b b d7a93&f=15&time= ( 微信用 ) openid=d32ffbe0ce1e7dccf15483d978365a40& userid= &username=fromusername&f=15&time= "dis":"f=15", "userid":" ", "feel":"003", "sbfeel":[ "feelofsb":"9","feelnum":"123","feelname":" 热水器 ","feelunit":" 度 ","feelstyle":"1", "feelofsb ":"1175","feelnum":"133","feelname":" 发动机位置 ","feelunit":" 坐标 ","feelstyle":"2", "feelofsb ":"1003","feelnum":"143","feelname":" 空调 ","feelunit":" 湿度 ","feelstyle":"3" ] "dis":"f=15",

9 e f6d d0f&username= obyu1jhlqtotlg7b0ozo9ugqs_bk&f=13&time= 请求获取设备拥有的已被授权的菜单列表( 微信用, 以为 id 为标志 ) openid=d32ffbe0ce1e7dccf15483d978365a40&username=fromusername&f=13&time= "dis":"f=13", "sbcom":[ "comname":" 热水器开 ","comsring":"open", "comname":" 热水器关 ","comsring":"close", "comname":" 热水器开 ","comsring":"open" ], "com":"003" "dis":"f=13", 7 增加设备自定义菜单 openid=d32ffbe0ce1e7dccf15483d978365a40&userid= &psw=4297f44b b d7a93&f=7&id=99&comname= 打开 &comstring=open&time=

10 "dis":"f=7", "userid":" ", "id":"99" "dis":"f=7", Comname: 命令菜单名称 ( 汉字 (UTF-8), 字母, 数字 ) Comstring: 命令字符内容 ( 汉字 (UTF-8), 字母, 数字, ) 8 绑定认证设备 openid=d32ffbe0ce1e7dccf15483d978365a40&userid= &psw=4297f44b b d7a93&serial=fuhome0102& rzid= &rzmm=adf28d9b7a8d08b5&sbname= 办公室的灯 &f=8&time= 根据系列识别码, 会自动添加菜单和传感器 "dis":"f=8", "sbid":" ", "sbname":" 办公室的灯 "

11 "dis":"f=8", rzid: 认证设备标签 10 位 id rzid: 认证设备标签 16 位 mm Sbid: 设备 10 位 id Sbname: 设备名称错误 : 设备 id 密码错误或已经添加 9 http 模式发送对设备的控制命令 ( 发送命令字符串 ) openid=d32ffbe0ce1e7dccf15483d978365a40&userid= &psw=4297f44b b d7a93&id=99&comstring=open&f=9&time= ( 微信用 ) openid=d32ffbe0ce1e7dccf15483d978365a40& userid= &wxname=fromusername&id=99&comstring=open&f=9&time= "dis":"f=9", "sbid":" ", "id":"99", "comstring":"open", "comback":"ok"

12 "dis":"f=9", sbid: 设备 10 位 id Sbname: 设备名字错误 : 设备 id 密码错误或已经添加 14 获取命令菜单名称所对应的命令字符串 openid=d32ffbe0ce1e7dccf15483d978365a40&userid= &psw=4297f44b b d7a93&comname=opendoor&f=14&time= "dis":"f=14", "id":"99", "sbname":" 房间的灯 ", "comname":"opendoor", "comstring":"open", "dis":"f=14", 10 请求最新传感器值

13 openid=d32ffbe0ce1e7dccf15483d978365a40&userid= &psw=4297f44b b d7a93&f=10&id=99&time= id: 返回的信息中的 id(99 是电风扇的 id) "dis":"f=10", "userid":" ", "id":"99", "sbtime":" :00:07", "statename":" 状态 ", "statevalue":"open" "feel":"003", "feelvalue":[ "feelnum":"200","feelvalue1":"50","feelvalue2":"","feelvalue3":"","feeltime":" :00:07", "feelnum":"201","feelvalue1":" ","feelvalue2":" ","feelvalue3":"","feeltime":" :00:07", "feelnum":"202","feelvalue1":"50","feelvalue2":"","feelvalue3":"","feeltime":" :00:07" ] "dis":"f=10",

14 11 请求指定时间段内的, 指定数目的传感器值 openid=d32ffbe0ce1e7dccf15483d978365a40&userid= &psw=4297f44b b d7a93&f=11&id=99&unum=200 &time1= &time2= &count=10&time= id: 返回的信息中的 id(99 是电风扇的 id) Umun: 传感器 3 位数编号 Time1: 起始时间 (Unix 时间戳 ) 可缺省 Time2: 终止时间 (Unix 时间戳 ) 可缺省 Count: 条数,0 为全部其他则按实际获取, 若大于实际条数, 则按实际条数返回 ( 微信用 ) openid=d32ffbe0ce1e7dccf15483d978365a40& userid= &username=fromusername&f=11&id=99&unum=200 &time1= &time2= &count=10&time= "dis":"f=11", "id":"99", "unum":"200", "sbtime":" :00:07", "statename":" 状态 ", "statevalue":"open" "feelcount":"003", "feelvalue":[ "feelnum":"200","feelvalue1":"50","feelvalue2":"","feelvalue3":"","feeltime":" :00:07", "feelnum":"200","feelvalue1":" ","feelvalue2":" ","feelvalue3":"","feeltime":" :00:07", "feelnum":"200","feelvalue1":"50","feelvalue2":"","feelvalue3":"","feeltime":" :00:07" ]

15 "dis":"f=11", 附录 : 其他错误集合 : W=1 : 参数非法 W=2 :openid 不可用 W=3 : 用户 psw 错误 F=f :f 类参数错误 POST 调试工具测试 : 测试信息 : Openid: d32ffbe0ce1e7dccf15483d978365a40 Username: lovelife Psw: 4297f44b b d7a93 Userid: 测试完成为 :1 注册 2 登录 3 激活认证设备 4 增加普通 DIY 设备 5 请求获取设备列表 6 请求获取设备菜单和传感器列表, 其他以此内推

第一章貓頭鷹傳信從很多方面來說哈利波特是一個非常不尋常的男孩舉一個例子來說, 一年之中他最憎恨的時期就是暑假了除此之外, 他的家庭作業還必須在死寂的夜晚裏偷

第一章貓頭鷹傳信從很多方面來說哈利波特是一個非常不尋常的男孩舉一個例子來說, 一年之中他最憎恨的時期就是暑假了除此之外, 他的家庭作業還必須在死寂的夜晚裏偷哈利波特 ( 三 ) 亞卡邦的囚犯目錄第一章貓頭鷹傳信...2 第二章瑪姬阿姨鑄下大錯...8 第三章騎士公車...16 第四章破釜...26 第五章狂戰士...37 第六章爪子和茶葉...52 第七章衣櫥裡的泥巴怪...67 第八章飛翔的胖淑女...78 第九章