# 查询设备描述 * **说明** > 获取某个设备的所有属性的详细描述信息列表，包括属性的名称、类型、值范围等信息。 * **URL**：/v1/device/desc/{did} * **请求方式**：GET * **Header参数**： | **Header\_Key** | **Header\_Value** | | :---: | :---: | | **ts** | 精确到ms的时间戳 | | **openid** | openid，每个个人用户的唯一标识 | | **applicationid** | 应用ID，每个开发者的唯一标识 | | **sign** | 加密签名，算法为SHA1\(HTTPMethod+RequestURI+params+ts+openkey+applicationkey\) | * **请求内容**： ``` 设备ID（参数在URL中） 其他参数 无 ``` * **返回内容** **成功时：** > 返回内容 ``` { "code": 0, "deviceName":"device name", "modelId":"abc123", "latitude":12.23; "longitude":25.21, "createTime":"2017-03-08T11:37:21", "lastLoginTime":"2017-03-08T13:37:21", "deviceVersion":"1.0.0.1", "moduleVersion":"2.0.1.4", "attrs": [ { "aid": 1, "type": 2, "name": "电器开关", "readOnly": 0, "cond": 1 }, { "aid": 2, "type": 1, "name": "有功功率值", "readOnly": 0, "min": 0, "max": 4294967296, "symbol": "W", "unit": "瓦特", "cond": 1 }, { "aid": 15, "type": 5, "name": "ss", "readOnly": 0, "vs": { "1": "制冷", "2": "制热" }, "cond": 0 } ] } ``` > 返回说明：code（成功标志）、固定字段（aid、type、name、readOnly、cond），若是数值类型则额外包含symbol、unit、max、min，如果是枚举类型，则额外包含vs。 | **参数名称** | **中文名称** | **类型** | **说明** | | :--- | :--- | :--- | :--- | | **deviceName** | 设备名称 | 字符串 | 用户定义的设备名称 | | **modelId** | 型号ID | 字符串 | 6位型号值 | | **latitude** | 经度 | 浮点型 | 设备所在位置，经度 | | **longitude** | 纬度 | 浮点型 | 设备所在位置，纬度 | | **createTime** | 创建时间 | 字符串 | 设备创建时间 | | **lastLoginTime** | 上次登录时间 | 字符串 | 设备上次登录时间 | | **deviceVersion** | 固件版本 | 字符串 | 设备固件版本 | | **moduleVersion** | 模块版本 | 字符串 | 设备模块版本 | | **aid** | 属性ID | 整型 | 属性ID | | **type** | 属性类型 | 整型 | 1数值、2开关、4泛型、5枚举 | | **name** | 属性名称 | 字符串 | 属性名称 | | **readOnly** | 只读标志 | 整型 | 0读写、1只读 | | **cond** | 联动标志 | 整型 | 1联动条件、2联动结果、3条件结果 | | **symbol** | 符号 | 字符串 | 如 升 | | **unit** | 单位 | 字符串 | 如 L | | **max** | 最大值 | 数值型 | 最大值 | | **min** | 最小值 | 数值型 | 最小值 | | **vs** | 枚举值 | JSON对象 | 枚举类型具体映射关系 | **失败时：** ``` { "code": ERRORCODE //ERRORCODE可以去错误码目录中查找 } ```