概述
本文档介绍通过机智云OpenApi获取卓虎硬件设备的数据的方法。
1. 卓虎硬件及APP
1、可通过淘宝或天猫网站购买卓虎硬件设备。
淘宝：
https://shop198103868.taobao.com/shop/view_shop.htm?spm=a1z0k.7628869.0.0.6ea43db2H9N0NJ&shop_id=198103868
天猫：
https://drohoo.tmall.com/search.htm?spm=a1z10.1-b-s.w5001-23966200193.6.646823660B1DwA&search=y&scene=taobao_shop
2、注册卓虎智能APP
在腾讯应用宝中搜索“卓虎智能”，并下载安装，安装完成后打开APP进行注册。
2. 用户登录
1、打开OpenAPI说明网站：http://docs.gizwits.com/zh-cn/Cloud/openapi_apps.html。点击“在线调试Open API”，然后点击“用户登录”。
2、点击“Authorze”，在弹框“ X-Gizwits-Application-Id”的value中填入App ID：1d5b0ff021614f42a44954c362d65992，然后点击“Authorze”完成。
3、点击“用户管理”->“用户登录”，在body中填入卓虎智能APP的账号及密码，然后点击试一下，响应码200即登录成功。
接口结构体如下：
POST
Header：'Content-Type: application/json'
'Accept: application/json'
'X-Gizwits-Application-Id: 1d5b0ff021614f42a44954c362d65992'
Body：{
"username": "你的app登录账号",
"password": "你的app登录密码",
"lang": "en"
}
请求URL:https://api.gizwits.com/app/login
响应体：
{
"token": "你的token",
"uid": "你的uid",
"expire_at": 1589611982
}
响应码：200
3. 获取绑定列表
1、点击“Authorize”，在弹框的“ X-Gizwits-User-token”的value中填入在上述登录获取的token，然后点击下方的“Authorize”完成。
2、点击“绑定管理”->“获取绑定列表”，然后点击下方的“试一下”即可获得绑定设备列表，响应码为200表示获取成功。
接口结构体如下：
GET
Header：'Accept: application/json'
'X-Gizwits-Application-Id: 1d5b0ff021614f42a44954c362d65992'
'X-Gizwits-User-token: 登录时获得的token'
请求URL:https://api.gizwits.com/app/bindings?limit=20&skip=0
响应体：
{
"devices": [
{
"protoc": 3,
"ws_port": 8080,
"port_s": 8883,
"wifi_soft_version": "04020801",
"gw_did": "",
"sleep_duration": 0,
"port": 1883,
"product_key": "41e95421a36f41b5ad2565b1c7391522",
"state_last_timestamp": 1575042577,
"role": "special",
"is_sandbox": false,
"type": "normal",
"product_name": "WiFi单相开关电测模块LCD版",
"is_disabled": false,
"host": "m2m.gizwits.com",
"dev_alias": "2",
"mesh_id": null,
"is_online": true,
"dev_label": [],
"wss_port": 8880,
"remark": "",
"did": "你的设备did",
"mac": "你的设备mac",
"passcode": "TTPDISLOPV",
"is_low_power": false
}
]
}
响应码：200
4. 获取设备最新状态
1、请求设备数据更新：点击“设备远程控制”->“远程控制设备”，在参数did中填入第2节中获取到的设备did，此时确保"is_online": true。在参数body中填入 { "raw":[18,255,255,255,255] }，然后点击“试一下”，返回响应码200即请求成功。
接口结构体如下：
POST
--header 'Content-Type: application/json'
--header 'Accept: application/json'
--header 'X-Gizwits-Application-Id: 1d5b0ff021614f42a44954c362d65992' --header 'X-Gizwits-User-token: 964db1c121674dae9afd2468cddfa11d'
Body {
"raw":[18,255,255,255,255]
}
请求URL
https://api.gizwits.com/app/control/{你的设备did}
响应码
200
2、获取设备最新状态：点击“设备远程控制”->“获取设备最新状态”，填写设备did，点击“试一下”，返回响应码200即请求成功。
接口结构体如下：
GET
--header 'Accept: application/json'
--header 'X-Gizwits-Application-Id: 1d5b0ff021614f42a44954c362d65992'
请求URL
'https://api.gizwits.com/app/devdata/{你的设备did}/latest'
响应体
{
"did": "pbZMtez5SqLidZFqAThDhH",
"updated_at": 1640575638,
"attr": {
"Nixietube_P1": "0.电压",
"Nixietube_P2": "0.电压",
"Q_value_P1": 0,
"Q_value_P2": 7.17,
"TimingTask_P1_10": "000000",
"Switch_P2": 1,
"CurrentLimttask_P2": "00000000",
"CurrentLimttask_P1": "00000000",
"Switch_P1": 0,
"Memory_P1": 0,
"Key_P2": 0,
"P_value_P2": 2.32,
"P_value_P1": 0,
"LED_enable": 0,
"Electricity_price": "0000000000000000000000000000",
"calibrationfactor":"03e803e803e803e803e803e803e803e803e803e803e803e803e803e803e803e803e8",
"Memory_P2": 0,
"TimingTask_P1_3": "000000",
"TimingTask_P1_2": "000000",
"TimingTask_P1_1": "000000",
"f_value": 50.02,
"TimingTask_P2_8": "000000",
"TimingTask_P1_6": "000000",
"TimingTask_P1_5": "000000",
"TimingTask_P1_4": "000000",
"TimingTask_P2_4": "000000",
"TimingTask_P1_7": "000000",
"TimingTask_P1_9": "000000",
"TimingTask_P1_8": "000000",
"TimingTask_P2_1": "000000",
"TimingTask_P2_2": "000000",
"TimingTask_P2_3": "000000",
"OpenTime_P1": "01000000",
"RT_measurement_P1": 0,
"Key_P1": 0,
"Energe_P2": "00000000",
"TimingTask_P2_9": "000000",
"EnergyLog": "0.缺省值",
"U_value": 232.74,
"Energe_P1": "00000000",
"Charge_P2": "00000000",
"I_value_P1": 0,
"I_value_P2": 0.0324,
"Charge_P1": "00000000",
"reserve4": "00000000",
"reserve5": "00000000",
"TimingTask_P2_5": "000000",
"Protect_P2": "0000000000",
"Protect_P1": "0000000000",
"TimingTask_P2_6": "000000",
"BatteryLeftCmd": "01200c12",
"PF_value_P1": 0,
"PF_value_P2": 0.308,
"TimingTask_P2_7": "000000",
"reserve1": "00000000",
"OpenTask_P1": "0.无任务",
"CirculationTask_P2": "00000000",
"CirculationTask_P1": "00000000",
"OpenTask_P2": "0.无任务",
"reserve2": "00000000",
"reserve3": "00000000",
"OpenTime_P2": "1c30c961",
"TimingTask_P2_10": "000000",
"DelayTask_P1": "000000",
"DelayTask_P2": "000000"
}
}
响应码
200
5. 远程设备控制命令使用
点击“设备远程控制”->“远程控制设备”，在参数did中填入第2节中获取到的设备did，此时确保"is_online": true。在参数body中填入 { "attrs": {"Switch_P1": false} }，然后点击“试一下”，返回响应码200即请求成功。
接口结构体如下：
POST
--header 'Content-Type: application/json'
--header 'Accept: application/json'
--header 'X-Gizwits-Application-Id: 1d5b0ff021614f42a44954c362d65992' --header 'X-Gizwits-User-token: 964db1c121674dae9afd2468cddfa11d'
Body {
"attrs": {"attr中的key":"attr中的value"}
}
例如控制开关关闭：
{
"attrs": {"Switch_P1": false}
}
请求URL
https://api.gizwits.com/app/control/{你的设备did}
响应码
200
结束
