公共接口(统一使用POST方式请求)


/*

 * 用户登录接口    请求地址:http://apithink.zmxiaomi.com/api/publics/login.html?mobile=&password=

 * @parammobilestring用户手机号

 * @parampassword         string用户登录密码

*/

接口数据返回

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明
token
string用户token
mobilestring用户手机号
usernamestring用户昵称


/*

 * 用户注册接口    请求地址:http://apithink.zmxiaomi.com/api/publics/register.html?username=&mobile=&code=&password=

* @paramusernamestring用户昵称

* @parammobilestring用户手机号

* @paramcodestring手机号验证码

* @parampassword         string密码

*/

接口数据返回

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明
token
string用户token
mobilestring用户手机号
usernamestring用户昵称


/*

 * 发送手机验证码    请求地址:http://apithink.zmxiaomi.com/api/publics/sendMobileCode.html?mobile=&type=

* @parammobile    string用户手机号

* @paramtype        int         请求类型,1:注册;2:忘记密码,3:绑定第三方,默认1

*/

接口数据返回

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明

/*

 * 重置密码    请求地址:http://apithink.zmxiaomi.com/api/publics/resetPassword.html?mobile=&code=&password=

 * @parammobilestring用户手机号

 * @paramtype         int请求标识,1:校验手机验证码是否正确;2:提交密码更改,默认1

 * @paramcodestring手机号验证码,type=1时不为空

 * @parampassword         string新密码,type=2时不为空

*/

接口数据返回

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明


/*

 * 重新生成token    请求地址:http://apithink.zmxiaomi.com/api/publics/resetToken.html?token=

 * @paramtokenstring已过期的token

*/

接口数据返回

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明

token
string最新生成的token

/*

 * 查看用户协议    请求地址:http://apithink.zmxiaomi.com/api/publics/userAgreement.html

 *    此页面是内嵌webView

*/


/**

* 第三方账号登录    请求地址:http://apithink.zmxiaomi.com/api/publics/threeAccount.html

 * @paramstring$tokens第三方登录tokens

 * @paramint$type第三方登录类型标识(1:微信;2:QQ;3:新浪微博)

 * @paramstring$username第三方昵称

 * @paramstring$face_pic第三方头像

*/


返回字段字段类型字段说明
code
string

请求状态:0,失败;1,成功

未绑定时,code返回-5,此时需要进入绑定手机号页面

message
string成功或失败的文字说明

tokenstring已绑定时返回,用户登录token
usernamestring已绑定时返回,用户昵称
threebool已绑定时返回,是否是第三方登录,true表示是,false表示不是
mobilestring已绑定时返回,用户手机号,第三方登录后目前此值未空字符串



/**

 * 第三方账号登录绑定手机号    请求地址:http://apithink.zmxiaomi.com/api/publics/bindMobile.html

 * @paramstring$tokens第三方登录tokens

 * @paramint$type第三方登录类型标识(1:微信;2:QQ;3:新浪微博)

 * @paramstring$mobile用户手机号

 * @paramstring$code手机验证码

 * @paramstring$username第三方昵称

 * @paramstring$face_pic         第三方头像

 */

返回字段字段类型字段说明
code
string

请求状态:0,失败;1,成功

message
string成功或失败的文字说明

tokenstring用户登录token
usernamestring用户昵称
threebool是否是第三方登录,true表示是,false表示不是
mobilestring用户手机号,第三方登录后目前此值未空字符串

用户个人中心接口(此模块接口默认传参用户token)


/*

 * 获取用户最新头像和昵称    请求地址:http://apithink.zmxiaomi.com/api/user/refreshInfo.html?token=

*/

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明

infoarray

username:用户昵称

face_pic:用户头像


/*

 * 用户更改头像    请求地址:http://apithink.zmxiaomi.com/api/user/updateUserFacePic.html?token=

*/

接口数据返回

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明


/*

 * 用户更改昵称    请求地址:http://apithink.zmxiaomi.com/api/user/updateUserName.html?token=

 * @paramusernamestring用户新昵称

*/

接口数据返回

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明

new_usernamestring用户新昵称


/*

 * 用户修改密码    请求地址:http://apithink.zmxiaomi.com/api/user/updatePassword.html?token=

 * @paramold_password         string用户老密码

 * @paramnew_passwordstring用户新密码

*/

接口数据返回

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明

设备相关接口(此模块接口默认传参用户token,post传参)

/*

 * 用户添加设备    请求地址:http://apithink.zmxiaomi.com/api/user/addDevices.html?token=

 * @paramserial_numstring设备序列号(设备UID)

 * @parampassword         string设备密码

*/

接口数据返回

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明


    /*

     * 进入设备温度、湿度设置主页面    请求地址:http://apithink.zmxiaomi.com/api/user/devicesSetting.html?token=

     * @paramdevices_idint设备ID

     * @paramtype     int设置类型,1:温度;2:湿度,默认1

    */

接口数据返回

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明

data
array

base_id:当前设置数据主键ID

devices_id:设备ID

info{

    title:设置说明(温度高于、低于)

    all(全部开关列表):{

         name:开关名称

         status:开关状态,0:关闭,1:开启

         info_id:当前设置中开关主键ID

    }

    close(关闭开关列表){

          

    }

    open(开启开关列表){

          

    }

}


/*

 * 进入设备温度、湿度设置添加、编辑页面    请求地址:http://apithink.zmxiaomi.com/api/user/editSetting.html?token=

 * @paramdevices_idint设备ID

 * @paramtypeint设置类型,1:温度;2:湿度,默认1

 * @paramstepint请求标识,1:进入本页面请求设置信息;2:提交编辑、新增请求,默认1

 * @paramsetting_listjsonArray         json数组(数组格式查看:http://apithink.zmxiaomi.com/uploads/json/add.json    http://apithink.zmxiaomi.com/uploads/json/edit.json)

*/

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明

defaultboolfalse:当前用户未设置过温度、湿度;true:设置过
data
arraydefault = false时返回字段{

         switch_id:当前设备下基础开关主键ID

          name:开关名称

}


default = true时返回data字段详见接口devicesSetting




/*

 * 删除设备温度、湿度设置    请求地址:http://apithink.zmxiaomi.com/api/user/delDevicesSetting.html?token=

 * @parambase_idstring设备温度、湿度设置主键ID(接口devicesSetting返回的base_id),多个以英文逗号分隔

*/

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明


/*

 * 修改开关名称    请求地址:http://apithink.zmxiaomi.com/api/user/updateSwitchName.html?token=

 * @paramdevices_idint设备client_id

 * @paramtypeint请求标识,1:进入编辑页面,获取全部开关数据;2:提交编辑更改,默认1

 * @paramsetting_listjsonArray         json数组,type=2时有效     json数组(数组格式查看:http://apithink.zmxiaomi.com/uploads/json/switch_name.json)

*/

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明

list
array

type=1时返回,当前设备全部开关信息

switch_id:开关ID

show_name:开关名称


/*

 * 编辑设备密码    请求地址:http://apithink.zmxiaomi.com/api/user/updateDevicesPassword.html?token=

 * @paramclient_id         string设备client_id

 * @paramold_password         string设备旧密码

 * @paramnew_passwordstring设备新密码

 * @paramrepeat_passwordstring再次输入设备新密码

*/

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明


/*

 * 设备时间校正    请求地址:http://apithink.zmxiaomi.com/api/user/checkDevicesTime.html?token=

 * @paramclient_idstring设备client_id

 * @paramtypeint请求标识,1:获取设备当前时间;2:同步服务器时间,默认1

*/

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明

current_timeint

type=1时返回,当前设备的时间,时间戳格式

同步服务器时间目前未实现,暂时只返回提示信息


/*

 * 获取设备温度、湿度数据    请求地址:http://apithink.zmxiaomi.com/api/user/getDevicesTHData.html?token=

 * @paramclient_idstring设备client_id

 * @paramflagint请求标识,1:同时获取温度、湿度和信号强度数据;2:单独获取温度、湿度或信号强度,默认1

 * @paramtypeint类型标识,1:获取温度数据;2:获取湿度数据,3:获取信号强度,flag=2时此字段有效

*/

flag=1时3种数据同时返回;flag=2时根据type不同返回不同数据(此接口因为暂时没有设备,目前还不能使用

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明

wendustring

温度数据

shidustring湿度数据
xinhaostring信号强度数据


/*

 * 进入定时设置主界面    请求地址:http://apithink.zmxiaomi.com/api/user/devicesTimePage.html?token=

 * @paramdevices_idstring设备id

*/

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明

listarray

为空表示当前用户没有进行过定时设置

不为空时字段说明:

id:定时设置主键ID

type:定时类型(1:单次;2:每天,3:自定义周几)

exe_time:详细定时执行时间,时间戳类型

type_name:定时文字显示

info数组返回包含open和close两个数组,字段说明:

switch_id:开关主键ID

show_name:开关名称

switch_listarray

当前设置默认开关列表,字段说明:

switch_id:开关主键ID

name:开关名称


/*

 * 新增、编辑定时设置    请求地址:http://apithink.zmxiaomi.com/api/user/devicesTimeSetting.html?token=

 * @param    devices_id    string           设备id

 * @param    setting_list    jsonArray    json数组(数组格式查看:http://apithink.zmxiaomi.com/uploads/json/mod_time.json)

*/

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明


/*

 * 用户删除设备    请求地址:http://apithink.zmxiaomi.com/api/user/delDevices.html?token=

 * @paramdevices_idint设备ID

*/

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明


/*

 * 进入设备主页面    请求地址:http://apithink.zmxiaomi.com/api/user/homePage.html?token=

 * @paramdevices_idint设备ID

*/

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明

devices_namestring设备名称
wendustring设备温度数据
shidustring设备湿度数据
xinhaostring设备信号强度数据
support_wsbool是否支持温湿度,true支持,false不支持
support_localbool是否支持本地控制,true支持,false不支持
is_controllerbool是否带受控显示功能,true带,false不带
support_wifibool是否支持wifi,true支持,false不支持
switch_listarray

当前设备开关数据

status:0,关,1,开

show_name:开关名称


/*

 * 设备开关全开\全关    请求地址:http://apithink.zmxiaomi.com/api/user/allOpenOrClose.html?token=

 * @param    devices_id    int    设备ID

 * @param    type   int    请求标识,0:全关;1:全开

*/

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明


/*

 * 设备开关全开\全关    请求地址:http://apithink.zmxiaomi.com/api/user/switchOpe.html?token=

 * @param    devices_id    int    设备ID

 * @param    switch_id   int  开关主键ID

 * @param    type   int    请求标识,0:全关;1:全开

*/

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明

/*

* 获取设备列表    请求地址:http://apithink.zmxiaomi.com/api/user/getDevicesList.html?token=

*/

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明
listarray

devices_id:设备主键ID

devices_name:设备名称

client_id:设备client_id

status:设备在线状态(0,不在线,1在线,2,手工调试锁定状态)


/*

 * 删除设备定时设置    请求地址:http://apithink.zmxiaomi.com/api/user/delTimeSetting.html?token=

 * @paramidint设备定时设置主键ID(接口devicesTimePage返回的id),多个以英文逗号分隔

*/

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明


/*

 * 新手指南(webview页面)    请求地址:http://apithink.zmxiaomi.com/api/user/tutorial.html?token=

 */

/*

* 设备锁定\解锁    请求地址:http://apithink.zmxiaomi.com/api/user/devicesLock.html?token=

 * @paramclient_idint设备ID

 * @paramtypeint请求标识,0:解锁;1:锁定

*/

返回字段字段类型字段说明
code
string请求状态:0,失败;1,成功
message
string成功或失败的文字说明