设备 Devices

导航中心
快速开始 开发示例 案例分析 客户端下载 API文档 传感云SDK 使用条款 常见问题

设备API (版本1.0)

API列表
device/v1/list 设备列表 查看接口
device/v1/show 查看设备 查看接口
device/v1/create 创建设备 查看接口
device/v1/update 编辑设备 查看接口
device/v1/destroy 删除设备 查看接口


设备列表

请求将得到所有设备信息的列表.

URL

http://api.wsncloud.com/device/v1/list

HTTP请求方式

GET

请求参数

参数名 必需 类型 说明
ak true string 用户密钥

返回结果

JSON

[
 {
 "id":"525bf69a144e76e2dcbb9901",
 "title":"树莓派",
 "description":"树莓派设备描述"
 },
 {
 "id":"525bf6ad144e76e2dcbb9902",
 "title":"空调监控",
 "description":"空调监控设备描述"
 }
]




查看设备

请求将得到所要查看设备的详细内容

URL

http://api.wsncloud.com/device/v1/show

HTTP请求方式

GET

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
id true string 设备ID

返回结果

JSON

{
 "id":"525c287313ac144f5e2370e2",
 "title":"空调控制",
 "tags":"空调,开关",
 "lat":"29.718514",
 "lng":"115.356198",
 "city":"黄石市",
 "description":"空调控制"
}



创建设备

创建一个设备

URL

http://api.wsncloud.com/device/v1/create

HTTP请求方式

POST

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
title true string 设备标题
description true string 描述
lat true string 纬度
lng true string 经度

返回结果

JSON

{ "id":"525c219b13ac144f5e2370e1",
 "title":"测试设备测试设备测试设备设备测试设备",
 "description":"这是一个测试设备描述"
}



编辑设备

根据设备ID编辑已经接入的设备

URL

http://api.wsncloud.com/device/v1/update

HTTP请求方式

POST

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
id true string 设备ID
title true string 设备标题
description true string 描述
lat true string 纬度
lng true string 经度

返回结果

JSON

{ 
 "id":"525c287313ac144f5e2370e2",
 "title":"空调控制新",
 "tags":"空调,开关",
 "lat":"39.851218",
 "lng":"116.295916",
 "city":"黄石市",
 "description":"这是一个测试设备描述新"
}



删除设备

删除指定的设备

URL

http://api.wsncloud.com/device/v1/destroy

HTTP请求方式

POST

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
id true string 设备ID

返回结果

JSON

{
 "status":"Ok",
 "info":"525c287313ac144f5e2370e2"
}