2.7设备信息同步接口
#### 接口路径：https://dev.lingju.ai/httpAuthApi/uploadEquipments.do
<table style="width:100%">
<tbody>
<tr height="28" style="font-weight:bold;">
<td height="28" width="130px" >名称</td>
<td colspan="3" >设备信息同步接口</td>
</tr>
<tr height="28" style="font-weight:bold;">
<td height="28" >接口路径</td>
<td colspan="3" >https://dev.lingju.ai/httpAuthApi/uploadEquipments.do</td>
</tr>
<tr height="28" style="font-weight:bold;">
<td height="28" >请求方式</td>
<td colspan="3" >post</td>
</tr>
</tbody>
</table>
#### http post请求示例：
~~~
post https://dev.lingju.ai/httpAuthApi/uploadEquipments.do
json格式串行化post上传，注意请求的header需添加 'Content-Type':'application/json;charset=UTF-8'
{
"appkey":"xxxxxxxxxxxxxxxxxxxxxx",
"userid":"XXXXXXXXXXXXXXXXXXXXXX",
"authcode":"XXXXXXXXXXXXXXXXXXXX",
"data":[{
"equip_id":"d1",
"name":"灯1",
"alias":"厨房灯",
"id":301,
"equip_location":"厨房",
"equip_type":1000,
"status":"OPEN",
"brightness":{"type":0,"progress":"80"},
"color":"RED",
"colortemp_value":2700,
"model_id":"345678",
"model_name":"睡眠模式",
"contextual_model":[
{"model_id":"123456","model_name":"阅读模式"},
{"model_id":"345678","model_name":"睡眠模式"}
]
},
{
"equip_id":"d2",
"name":"灯2",
"alias":"厕所灯",
"id":301,
"equip_location":"厕所",
"equip_type":1000,
"status":"OPEN",
"brightness":{"type":0,"progress":"30"},
"color":"BLUE",
"colortemp_value":2300,
"model_id":"789456",
"model_name":"变幻模式",
"contextual_model":[
{"model_id":"987456","model_name":"温馨模式"},
{"model_id":"789456","model_name":"变幻模式"}
]
},
{
"equip_id":"k1",
"name":"空调",
"alias":"卧室空调",
"id":301,
"equip_location":"卧室",
"equip_type":1001,
"status":"OPEN",
"mode":"ZHILENG",
"temperature":{"type":0,"progress":"18"}
}
]
}
~~~
#### 请求参数说明：
<table style="width:100%">
<thead>
<tr height="28">
<th width="130px">参数</th>
<th width="100px">数据类型</th>
<th width="130px">可需</th>
<th colspan="2" >描述</th>
</tr>
</thead>
<tbody>
<tr height="23" style="height:17.25pt">
<td height="23" >appkey</td>
<td >String</td>
<td>必填</td>
<td colspan="2" >分配给开发者的专属appkey，请妥善保管</td>
</tr>
<tr >
<td>userid</td>
<td>String</td>
<td>必填</td>
<td colspan="2">终端用户的唯一标识，移动设备建议使用mac地址，入网许可号等，注意取值必须为：[A-Za-z0-9]。请开发者务必注意区分userid,智能云根据userid标识终端id并实现授权限制及个性化的上下文应答。</td>
</tr>
<tr>
<td>authcode</td>
<td>String</td>
<td>必填</td>
<td colspan="2">给开发者分配的授权码，由开发者自行管理</td>
</tr>
<tr>
<td rowspan="3">data</td>
<td rowspan="3">List</td>
<td rowspan="3">必填</td>
<td colspan="2">IoT对象集合，IoT对象数据结构请参照下方IoT对象字段说明</td>
</tr>
</tbody>
</table>
#### 接口返回JSON示例：
~~~
{
"status":0
}
~~~
#### 接口返回说明：
~~~
Content-Type:application/json;charset=UTF-8
~~~
<table style="width:100%">
<thead>
<tr height="28" >
<th height="28" width="130px">属性名</th>
<th width="100px">数据类型</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr height="23">
<td height="23" >status</td>
<td>int</td>
<td>状态码，0=成功，其它值则为错误码，请参考错误码表</td>
</tr>
<tr height="23">
<td height="23" >description</td>
<td >String</td>
<td>通常为空，出错时会有错误信息</td>
</tr>
</tbody></table>
#### IoT对象字段说明
| 字段 | 数据类型 | 释义 | 取值 | 取值释义 |
|-----------------|----------|--------------|-------------------|--------------------|
| id | int | 目标对象ID | 301 | |
| equip_type | int | 设备类别 | 1000 | 灯 |
| | | | 1001 | 空调 |
| | | | 1002 | 风扇 |
| | | | 1003 | 电热器/电暖器 |
| | | | 1004 | 洗衣机 |
| | | | 1005 | 浴霸/风暖 |
| | | | 1006 | 热水器 |
| | | | 1007 | 排风扇 |
| | | | 1008 | 电吹风 |
| | | | 1009 | 冰箱 |
| | | | 1010 | 电压力锅/电饭煲 |
| | | | 1011 | 微波炉 |
| | | | 1012 | 咖啡机 |
| | | | 1013 | 油烟机 |
| | | | 1014 | 净水器 |
| | | | 1015 | 面包机 |
| | | | 1016 | 消毒柜 |
| | | | 1017 | 榨汁机/料理机 |
| | | | 1018 | 电磁炉 |
| | | | 1019 | 烤箱/电烤箱 |
| | | | 1020 | 电饼铛 |
| | | | 1021 | 豆浆机 |
| | | | 1022 | 酸奶机 |
| | | | 1023 | 电水壶 |
| | | | 1024 | 电视机 |
| | | | 1025 | 按摩器 |
| | | | 1026 | 音箱/音响 |
| | | | 1027 | 按摩椅 |
| | | | 1028 | 收音机 |
| | | | 1029 | 录音机 |
| | | | 1030 | 影碟机 |
| | | | 1031 | 录像机 |
| | | | 1032 | 投影机 |
| | | | 1033 | 净化器 |
| | | | 1034 | 吸尘器 |
| | | | 1035 | 加湿器 |
| | | | 1036 | 扫地机器人 |
| | | | 1037 | 熨斗 |
| | | | 1038 | 除湿机/抽湿机 |
| | | | 1039 | 计算机/电脑/笔记本 |
| | | | 1040 | 平板 |
| | | | 1041 | 手机 |
| | | | 1042 | 身高仪 |
| | | | 1043 | 体重秤 |
| | | | 1044 | 温度计 |
| | | | 1045 | 湿度计 |
| | | | 1046 | 空气质量仪 |
| | | | 1047 | 门 |
| | | | 1048 | 窗 |
| | | | 1049 | 窗帘 |
| | | | 1050 | 新风系统 |
| | | | 1051 | 饮水机 |
| | | | 1052 | 电话机 |
| | | | 1053 | 机顶盒 |
| | | | 1054 | 打印机 |
| | | | 1055 | 插座 |
| | | | 1056 | 电动锁 |
| | | | 1057 | 煤气罐 |
| | | | 1058 | 门磁开关 |
| | | | 1059 | 幕帘 |
| | | | 1060 | 门铃 |
| | | | 1061 | 水表 |
| | | | 1062 | 智能终端 |
| | | | 1063 | 开关 |
| | | | 1064 | 电表 |
| | | | 1065 | 面板 |
| | | | 1066 | 探测器 |
| | | | 1067 | 门磁传感器 |
| | | | 1068 | 排烟罩 |
| | | | 1069 | 燃气灶 |
| | | | 1070 | 门锁 |
| | | | 1071 | 摄像头 |
| | | | 1072 | 破壁机 |
| | | | 1073 | 网关 |
| | | | 1074 | 断路器 |
| | | | 1075 | 制冰机 |
| | | | 1076 | 报警器 |
| | | | 1077 | 电热毯 |
| | | | 1078 | 液位传感器 |
| | | | 1079 | 温湿度采集单元 |
| | | | 1080 | 跑步机 |
| | | | 1081 | 浴缸 |
| | | | 1082 | 按钮 |
| | | | 1083 | 空气盒子 |
| | | | 1084 | 地暖器 |
| | | | 1085 | 机器人 |
| | | | 1086 | 推窗器 |
| | | | 1087 | 马桶 |
| | | | 1088 | 中控屏 |
| | | | 1089 | 遥控器 |
| | | | 1090 | 鱼缸 |
| | | | 1091 | 控制器 |
| | | | 1092 | 网络存储 |
| | | | …… | （往后将支持更多设备） |
| equip_id | String | 设备id | | |
| name | String | 设备名称 | | |
| alias | String | 设备别名 | | |
| equip_location | String | 设备所属地点 | 客厅 | 客厅 |
| | | | 卧室 | 卧室（主卧） |
| | | | 次卧 | 次卧 |
| | | | 客房 | 客房 |
| | | | 书房 | 书房 |
| | | | 儿童房 | 儿童房 |
| | | | 餐厅 | 餐厅 |
| | | | 阳台 | 阳台/客厅阳台 |
| | | | 生活阳台 | 生活阳台 |
| | | | 门厅 | 门厅（厅） |
| | | | 厨房 | 厨房 |
| | | | 卫生间 | 公共卫生间 |
| | | | 主卧卫生间 | 主卧卫生间 |
| | | | 储藏室 | 储藏室（储藏间） |
| | | | 仓库 | 仓库 |
| | | | 走廊 | 走廊 （过道） |
| | | | 保姆房 | 保姆房 |
| | | | 玄关 | 玄关 |
| | | | 门口 | 门口 |
| | | | …… | （往后将支持更多地点） |
| brightness | Object | 亮度 | | progress对象 |
| volume | Object | 音量 | | progress对象 |
| electricity | Object | 电量 | | progress对象 |
| range | Object | 打开幅度 | | progress对象 |
| wakeup | String | 唤醒 | ON | 开启唤醒 |
| | | | OFF | 关闭唤醒 |
| facerecognition | String | 人脸识别 | ON | 开启人脸识别 |
| | | | OFF | 关闭人脸识别 |
| temperature | Object | 温度 | | progress对象 |
| humidity | Object | 湿度 | | progress对象 |
| weight | double | 重量 | | |
| height | double | 高度 | | |
| level | int | 档位 | | |
| winddirection | String | 风向 | LEFTRIGHT | 左右风向 |
| | | | UPDOWN | 上下风向 |
| | | | UP | 向上 |
| | | | DOWN | 向下 |
| | | | LEFT | 向左 |
| | | | RIGHT | 向右 |
| windtype | String | 风种 | CONCENTRATE | 集中 |
| | | | SPREAD | 扩散 |
| windswept | String | 扫风 | ON | 开启扫风 |
| | | | OFF | 关闭扫风 |
| lighting | String | 照明 | ON | 开启照明 |
| | | | OFF | 关闭照明 |
| shuxian | String | 数显 | ON | 开启数显 |
| | | | OFF | 关闭数显 |
| childlock | String | 童锁 | ON | 开启童锁 |
| | | | OFF | 关闭童锁 |
| water | Object | 水量 | | progress对象 |
| quality | String | 质量 | | |
| kougan | String | 口感 | QINGXIANG | 清香 |
| | | | BIAOZHUN | 标准 |
| | | | NONGYU | 浓郁 |
| rotatecycle | int | 旋转周期 | | |
| baoya | String | 保压 | ON | 开启保压 |
| | | | OFF | 关闭保压 |
| rotate | String | 旋转 | ON | 开启旋转 |
| | | | OFF | 关闭旋转 |
| shangxiapan | String | 上下盘 | UP | 上盘 |
| | | | DOWN | 下盘 |
| view3d_2d | String | 3D/2D | | |
| power | double | 功率 | | |
| turnover | String | 翻面 | ON | 开启翻面 |
| | | | OFF | 关闭翻面 |
| grainsize | String | 颗粒大小 | SMALL | 小 |
| | | | MEDIUM | 中等 |
| | | | BIG | 大 |
| concentration | Object | 浓度 | | progress对象 |
| quantity | double | 份量 | | |
| cups | double | 杯数 | | |
| storages | String | 存储内容 | AUDIO | 音频 |
| | | | VIDEO | 视频 |
| | | | IMAGE | 图片 |
| autofeeding | String | 自动投料 | ON | 开启自动投料 |
| | | | OFF | 关闭自动投料 |
| inputtext | String | 文字输入 | ON | 开启文字输入 |
| | | | OFF | 关闭文字输入 |
| photograph | String | 拍照 | ON | 开启拍照 |
| | | | OFF | 关闭拍照 |
| videotape | String | 录像 | ON | 开启录像 |
| | | | OFF | 关闭录像 |
| bluetooth | String | 蓝牙 | ON | 开启蓝牙 |
| | | | OFF | 关闭蓝牙 |
| wifi | String | Wifi | ON | 开启Wifi |
| | | | OFF | 关闭WiFi |
| location | String | 定位 | ON | 开启定位 |
| | | | OFF | 关闭定位 |
| status | String | 状态 | OPEN | 打开状态 |
| | | | CLOSE | 关闭状态 |
| | | | BEGIN | 开始状态 |
| | | | FINISH | 结束状态 |
| | | | PAUSE | 暂停状态 |
| | | | CONTINUE | 继续状态 |
| channel | int | 频道 | | |
| menu | String | 菜单 | ON | 开启菜单 |
| | | | OFF | 关闭菜单 |
| grade | int | 等级/强度 | | |
| screen | String | 屏幕 | ON | 开启屏幕 |
| | | | OFF | 关闭屏幕 |
| color | String | 颜色 | | |
| colortemp | String | 色温 | WARM | 暖色 |
| | | | COOL | 冷色 |
| repeat | int | 重复次数 | | |
| soundtrack | String | 声道 | | |
| model_name| String | 当前模式名称 | | |
| model_id| String | 当前模式 ID | | |
| contextual_model| List| 情景模式 | | contextual_model对象 |
| mode | String | 设备运行模式 | DEFAULT | 常规模式 |
| | | | MUTE | 静音模式 |
| | | | VIBRATOR | 震动模式 |
| | | | FLIGHT | 飞行模式 |
| | | | INLAY | 内置模式 |
| | | | OUTLAY | 外置模式 |
| | | | ZHILENG | 制冷模式 |
| | | | ZHIRE | 制热模式 |
| | | | CHOUSHI | 抽湿模式 |
| | | | LENGDONG | 冷冻模式 |
| | | | RUANLENGDONG | 软冷冻模式 |
| | | | PIAOXI | 漂洗模式 |
| | | | TUOSHUI | 脱水模式 |
| | | | CHUJUN | 除菌模式 |
| | | | HUANQI | 换气模式 |
| | | | GANZAO | 干燥模式 |
| | | | BAOWEN | 保温模式 |
| | | | LENGCANG | 冷藏模式 |
| | | | SONGFENG | 送风模式 |
| | | | JIASHI | 加湿模式 |
| | | | SHUIMIAN | 睡眠模式 |
| | | | JIENENG | 节能模式 |
| | | | QINGJIE | 清洁模式 |
| | | | ZUIKUAI | 最快模式 |
| | | | ZUIJING | 最净模式 |
| | | | XICUNSHAN | 洗寸衫模式 |
| | | | XIYANGMAO | 洗羊毛模式 |
| | | | XICHUANGDAN | 洗床单模式 |
| | | | XINIUZAI | 洗牛仔模式 |
| | | | XIMIANMA | 洗棉麻模式 |
| | | | XIYURONG | 洗羽绒模式 |
| | | | XISICHOU | 洗丝绸模式 |
| | | | HUNHE | 混合模式 |
| | | | YEJIANXI | 夜间洗模式 |
| | | | YEWAN | 夜晚模式 |
| | | | ZHAOMING | 照明模式 |
| | | | CHUIFENG | 吹风模式 |
| | | | KUAISUFENGGAN | 快速风干模式 |
| | | | QUJINGDIAN | 去静电模式 |
| | | | BAOSHI | 保湿模式 |
| | | | CHUILIAN | 吹脸模式 |
| | | | PENGSONG | 蓬松模式 |
| | | | HENGWEN | 恒温模式 |
| | | | KUAISUZHU | 快速煮模式 |
| | | | ZHUZHOU | 煮粥模式 |
| | | | ZHENGCAI | 蒸菜模式 |
| | | | ZHUFAN | 煮饭模式 |
| | | | BAOTANG | 煲汤模式 |
| | | | DOULEITIJIN | 豆类蹄筋 |
| | | | ROULEI | 肉类模式 |
| | | | DANGAO | 蛋糕模式 |
| | | | YULEI | 鱼类模式 |
| | | | ZAIJIARE | 再加热模式 |
| | | | ZALIANGZHOU | 杂粮粥模式 |
| | | | RECAI | 热菜模式 |
| | | | SHAOKAO | 烧烤模式 |
| | | | YETI | 液体模式 |
| | | | JIEDONG | 解冻模式 |
| | | | MIFAN | 米饭模式 |
| | | | APP | 手机APP模式 |
| | | | SHENGKONG | 声控模式 |
| | | | ROUSONG | 翻炒干货模式 |
| | | | MIANBAO | 面包模式 |
| | | | SHENGDIAN | 省电模式 |
| | | | NAIPAO | 奶泡制作模式 |
| | | | YISHIKAFEI | 意式咖啡模式 |
| | | | CHA | 茶模式 |
| | | | NATIE | 拿铁模式 |
| | | | MAQIDUO | 玛奇朵模式 |
| | | | KABUQINUO | 卡布奇诺模式 |
| | | | SUANXING | 酸性模式 |
| | | | RUOSUANXING | 弱酸性模式 |
| | | | JIANXING | 碱性模式 |
| | | | RUOJIANXING | 弱碱性模式 |
| | | | KUAISU | 快速模式 |
| | | | TUSI | 土司模式 |
| | | | FASHIMIANBAO | 法式面包模式 |
| | | | QUANMAIMIANBAO | 全麦面包模式 |
| | | | HEIMAIMIANBAO | 黑麦面包模式 |
| | | | DANMAIMIANBAO | 丹麦面包模式 |
| | | | HUASHIMIANBAO | 花式面包模式 |
| | | | SHUANGFENGMIANBAO | 双峰面包模式 |
| | | | OUSHIMIANBAO | 欧式面包模式 |
| | | | HEFENGMIANBAO | 和风面包模式 |
| | | | WUJINMIANBAO | 无筋面包模式 |
| | | | WUTANGMIANBAO | 无糖面包模式 |
| | | | PISAMIANTUAN | 披萨面团模式 |
| | | | JIAOMUMIANBAO | 酵母面包模式 |
| | | | YINGSHISIKANG | 英式茶饼思康饼模式 |
| | | | SHUSHIDANGAO | 蔬食蛋糕模式 |
| | | | GUOJIANG | 果酱模式 |
| | | | DOUSHAXIAN | 豆沙馅模式 |
| | | | MASHU | 麻薯模式 |
| | | | WUDONGMIAN | 乌冬面模式 |
| | | | YIDALIMIAN | 意大利面模式 |
| | | | NIANGAO | 年糕模式 |
| | | | XIAODU | 消毒模式 |
| | | | HONGGAN | 烘干模式 |
| | | | DOUJIANG | 豆浆模式 |
| | | | GUOSHU | 果蔬模式 |
| | | | NONGTANG | 浓汤模式 |
| | | | MIHU | 米糊模式 |
| | | | YUMIZHI | 玉米汁模式 |
| | | | AOZHOU | 熬粥模式 |
| | | | SHOUDONG | 手动模式 |
| | | | YAOKONG | 遥控模式 |
| | | | BINGSHA | 冰沙模式 |
| | | | NAIXI | 奶昔模式 |
| | | | WUGU | 五谷模式 |
| | | | HUOGUO | 火锅模式 |
| | | | CHAOCAI | 炒菜模式 |
| | | | SHAOSHUI | 烧水模式 |
| | | | TIEBANSHAO | 铁板烧模式 |
| | | | FAJIAO | 发酵模式 |
| | | | XUANZHUAN | 旋转模式 |
| | | | CUIPIHONGBEI | 脆皮烘焙模式 |
| | | | CHUANTONGHONGBEI | 传统烘焙模式 |
| | | | ZHENGQIXIAODU | 蒸汽消毒模式 |
| | | | KAOYU | 烤鱼模式 |
| | | | GUOTIE | 锅贴模式 |
| | | | JIANDAN | 煎蛋模式 |
| | | | ROUBING | 肉饼模式 |
| | | | PISA | 披萨模式 |
| | | | BINGGAN | 饼干模式 |
| | | | CONGHUABING | 葱花饼模式 |
| | | | XIANBING | 馅饼模式 |
| | | | GANDOUDOUJIANG | 干豆豆浆模式 |
| | | | SHIDOUDOUJIANG | 湿豆豆浆模式 |
| | | | WUGUDOUJIANG | 五谷豆浆模式 |
| | | | LVDOUDOUJIANG | 绿豆豆浆模式 |
| | | | GUOCU | 果醋模式 |
| | | | MIJIU | 米酒模式 |
| | | | NADOU | 纳豆模式 |
| | | | ROUNIE | 揉捏模式 |
| | | | JIARE | 加热模式 |
| | | | ZHENYA | 针压模式 |
| | | | JINGJI | 经济模式 |
| | | | SUANNAI | 酸奶模式 |
| | | | PAOCAI | 泡菜模式 |
| | | | FANCHAO | 翻炒干货模式 |
| | | | ROUSONG | 肉松模式 |
| | | | APP | 手机APP模式 |
| | | | SHENGKONG | 声控模式 |
| | | | SHOUDONG | 手动模式 |
| | | | YAOKONG | 遥控模式 |
| | | | …… | （按需扩展） |
PS:以上为所有设备的字段属性说明，单个设备的字段说明参考附录中的IoT对象各设备属性说明（一）和（二）
progress对象数据结构:
| 属性 | 类型 | 释义 | 取值 | 属性取值释义 |
|----------|--------|--------------|------|------------------------------------------|
| type | int | 进度控制类型 | 0 | 设置进度值为progress的值,百分比值 |
| progress | String | 进度值 | 0-100 | |
contextual_model对象数据结构:
| 属性 | 类型 | 释义 | 取值 | 属性取值释义 |
|----------|--------|--------------|------|------------------------------------------|
| model_name| String | 模式名称 | | |
| model_id| String | 模式 ID | | |