IOT API Reference

相关参考

HTTP 协议参考 常用 RESETFUL 错误代码

API

下面的表列出一套完整的操作可以执行与 TONYLABS IoT API。产品，设备，钥匙，触发器，数据流和数据。每个资源都有特定的属性。 注意：如果不指定格式/媒体类型 JSON或XML 与 IoT API进行交互时，默认的格式接受/返回 JSON。 

用户注册

用户注册时，App 开发者需要注意密码需要通过 MD5 或 SHA 先将密码加密后，再发送，性别（Gender）字段为字符串类型，可接受如 Male|Female 或 '男'|'女'，亦可 0|1 区分，生日日期格式为 YYYY-mm-dd 

PUT http://iot.swiftio.cc/beta/rest/user/register.json

{
"version":"1.0.0",
"username":"",
"email":"",
"passwd":"MD5()",
"phone":"",
"idcard":"",
"gender":"Male|Female",
"birthday":"YYYY-mm-dd"
}

 Return JSON 

{"status":"200"}

用户登录

POST http://iot.swiftio.cc/beta/rest/user/login.json

{
"version":"1.0.0",
"username":"",
"email":"",
"passwd":""
}

 Return JSON

{
"uid":"47",
"username":"USERNAME",
"password":"PASSWRD",
"email":"EMAIL",
"email_verified":"0",
"uuid":null,
"role":"citizen",
"city":null,
"country":null,
"website":null,
"idcard":"IDCARD_NUMBER",
"gender":"MALE",
"phone":"PHONE_NUMBER",
"birthday":"1999-08-14",
"last_login_time":null,
"last_login_ip":null,
"login_count":"0",
"lock":"0",
"ctime":"2014-10-24 10:58:58",
"mtime":null
}

 用户信息查询 (JSON) 

GET http://iot.swiftio.cc/beta/rest/user/UID_HERE.json

{
"version":"1.0.0",
"username":"",
"email":"",
"passwd":""
}

 Return JSON

{
"uid":"47",
"username":"USERNAME",
"password":"PASSWRD",
"email":"EMAIL",
"email_verified":"0",
"uuid":null,
"role":"citizen",
"city":null,
"country":null,
"website":null,
"idcard":"IDCARD_NUMBER",
"gender":"MALE",
"phone":"PHONE_NUMBER",
"birthday":"1999-08-14",
"last_login_time":null,
"last_login_ip":null,
"login_count":"0",
"lock":"0",
"ctime":"2014-10-24 10:58:58",
"mtime":null
}

用户信息查询 (HTML)

GET http://121.40.153.169/api/user_login?version=1.0.0&username=xxx&email=xxx@xxx.com&passwd=md5(xxx)

NO BODY

Return JSON

{
"uid":"47",
"username":"USERNAME",
"password":"PASSWRD",
"email":"EMAIL",
"email_verified":"0",
"uuid":null,
"role":"citizen",
"city":null,
"country":null,
"website":null,
"idcard":"IDCARD_NUMBER",
"gender":"MALE",
"phone":"PHONE_NUMBER",
"birthday":"1999-08-14",
"last_login_time":null,
"last_login_ip":null,
"login_count":"0",
"lock":"0",
"cTime":"2014-10-24 10:58:58",
"mTime":null
}

 用户节点设备列表 (JSON)

GET http://iot.swiftio.cc/beta/rest/node/user/UID_HERE.json

[javascript] { "version":"1.0.0", "username":"", "email":"", "passwd":"" } [/javascript]

Return JSON

[javascript] [ { "uid":"5", "user_device_name":"My Living Room Power Jack", "user_device_mac":"843A4B0DAA20", "user_device_lock":"1", "device_id":"13", "device_machine_name":"5_channels_jack", "device_description":"Manufactory Warning Message for User" }, { "uid":"5", "user_device_name":"My Bedroom Power Jack", "user_device_mac":"843A4B0DAA11", "user_device_lock":"0", "device_id":"13", "device_machine_name":"5_channels_jack", "device_description":"Manufactory Warning Message for User" } ] [/javascript]

用户节点设备列表 (HTML)

GET http://iot.swiftio.cc/beta/rest/node/list?username=xxx&email=xxx&passwd=md5(xxx)

[javascript] NO BODY [/javascript]

Return JSON

[javascript] [ { "uid":"5", "user_device_name":"My Living Room Power Jack", "user_device_mac":"843A4B0DAA20", "user_device_lock":"1", "device_id":"13", "device_machine_name":"5_channels_jack", "device_description":"Manufactory Warning Message for User" }, { "uid":"5", "user_device_name":"My Bedroom Power Jack", "user_device_mac":"843A4B0DAA11", "user_device_lock":"0", "device_id":"13", "device_machine_name":"5_channels_jack", "device_description":"Manufactory Warning Message for User" } ] [/javascript]

节点设备绑定/更新

当用户完成注册并登录后，用户通过手机 App 与智能设备通过 SmartConfig 配对，配对成功后，智能设备把该设备的 UUID、 machine_name 和 MAC 地址传回 App, 并通过该节点设备绑定/更新API登记。已登记绑定的设备，如需更新用户自定义设备名称，或锁定该设备，仍使用此方法更新，程序将自动判断。 

POST http://iot.swiftio.cc/beta/rest/device/MAC_ADDRESS_HERE.json

[javascript] { "version":"1.0.0", "uid":"USER_ID_FROM_USER_LOGIN_STEP", "uuid":"MANUFACTORY_OR_DEVELOPER_UUID", "machine_name":"MACHINE_NAME_FROM_MCU", "name":"USER_DEFINED_DEVICE_NAME", "lock":"1||0" } [/javascript]

Return JSON

[javascript] { "status": 200, "msg": "Node updated." } [/javascript] [javascript] { "status": 200, "msg": "Node bound." } [/javascript]

用户节点设备删除

用户通过App删除节点设备，App 只需要将用户设备中的 UUID、MAC 地址和当前用户ID 通过 DELETE 请求即可。 

DELETE http://121.40.153.169/api/channel/MAC_ADDRESS_HERE.json

[javascript] { "version" : "1.0.0", "username" : "xxxx", "passwd" : "md5(xxxxxx)" } [/javascript]

Return JSON

{"status":"200"}

心跳发送  (设备端) (HTML)

PUT http://121.40.153.169/api/node_heartbeat?version=1.0.0&mac=xxxxxxxx

[javascript] {"version:"1.0.0", "mac":"AABBCCDDEEFF"} [/javascript]

Return JSON

心跳检测  (App 端) (HTML)

GET http://121.40.153.169/api/node_heartbeat?version=1.0.0&mac=xxxxxxxx

No body

Return JSON

[javascript] { {"status":200} } [/javascript]

节点设备通道数据读取(JSON)

GET http://iot.swiftio.cc/beta/rest/channel/MAC_ADDRESS_HERE.json

{
"version":"1.0.0",
"uuid":"xxx-xxxx-xxxxx-xxxxxx",
"device_alt":"1415196715" (Optional)
}

Return JSON

{
"device_machine_name":"xx_xxx_xx",
"device_description":"xxxxxxxx",
"device_alt":"1415196715",
"channel":
{
"channel1":
{
"channel_value":"100",
"channel_alt":"1414206622"
},
"channel2":
{
"channel_value":"200",
"channel_alt":"1414206622"
},
}
}

节点设备通道数据读取(HTML)

GET http://iot.swiftio.cc/beta/rest/channel/data?version=1.0.0&mac=xxxxxxxx&uuid=xxxx-xxxx-xxx-xxxx&device_alt=1415196715(Optional)

NO Body

Return JSON

{
"device_machine_name":"xxx_xxx_xx",
"device_description":"xxxxxxxxxx",
"device_alt":"1415196715",
"channel":
{
"channel1":
{
"channel_value":"100",
"channel_alt":"1414206622"
},
"channel2":
{
"channel_value":"200",
"channel_alt":"1414206622"
},
}
}

节点设备通道数据发送

PUT http://iot.swiftio.cc/beta/rest/channel/MAC_ADDRESS_HERE.json

{
"version" : "1.0.0",
"uuid" : "xxx-xxxx-xxx-xxxx-xxx",
"datastreams" : [
{
"channel" : "channel1",
"value" : "1"
},
{
"channel" : "channel2",
"value" : "2"
} ]
}