传感器 Sensors

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

传感器API (版本1.0)

API列表
sensor/v1/list 传感器列表 查看接口
sensor/v1/show 查看传感器 查看接口
sensor/v1/create 创建传感器 查看接口
sensor/v1/update 编辑传感器 查看接口
sensor/v1/destroy 删除传感器 查看接口


传感器列表

请求将得到某设备下所有传感器的列表.

URL

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

HTTP请求方式

GET

请求参数

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

返回结果

JSON

[
 {
 "id":"525d621313ac202c1ca5ad38",
 "title":"家庭开关",
 "type":"OnOff",
 "description":"开关传感器描述"
 },
 {
 "id":"525d61f213ac202c1ca5ad37",
 "title":"数值传感器",
 "type":"Numerical",
 "description":"数值传感器描述"
 }
]



查看传感器

请求将得到所要查看传感器的详细内容

URL

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

HTTP请求方式

GET

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
id true string 传感器ID

返回结果

JSON

{
 "id":"525d61f213ac202c1ca5ad37",
 "title":"数值传感器",
 "type":"Numerical",
 "tags":"数值,设备",
 "unit":"摄氏度",
 "symbol":"°C",
 "description":"数值传感器描述"
}



创建传感器

创建一个新的传感器

URL

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

HTTP请求方式

POST

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
deviceId true string 设备ID
title true string 传感器标题
type true string

传感器类别,可选值:

("Numerical", "数值型传感器")

("OnOff", "开关")

("Gps", "GPS")

("Generic", "泛型传感器")

("Pic", "图像传感器")

description true string 描述
unit true string 单位名称
symbol true string 单位符号

返回结果

JSON

{
 "id":"525d6c0213ac202c1ca5ad3b",
 "title":"客厅温度仪",
 "type":"Numerical",
 "description":"这是一个设备描述"
}



编辑传感器

根据传感器ID编辑已经接入的传感器

URL

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

HTTP请求方式

POST

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
id true string 设备ID
title true string 设备标题
description true string 描述
unit true string 单位名称
symbol true string 单位符号

返回结果

JSON

{
 "id":"525d61f213ac202c1ca5ad37",
 "title":"客厅温度仪新",
 "type":"Numerical",
 "tags":"数值,设备",
 "unit":"华氏度",
 "symbol":"°C",
 "description":"这是一个设备描述新"
}



删除传感器

删除指定的传感器

URL

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

HTTP请求方式

POST

请求参数

参数名 必需 类型 说明
ak true string 用户密钥
id true string 传感器ID

返回结果

JSON

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