联犀-things
  1. info
联犀-things
  • things
    • device
      • auth
        • 设备操作认证
        • 设备登录认证
        • 设备自动注册
        • 鉴定是否是root账号
      • auth5
        • 设备操作认证
        • 设备登录认证
      • gateway
        • 获取子设备列表
        • 添加网关子设备
        • 解绑子设备
      • info
        • 绑定
          POST
        • 创建绑定token
          POST
        • 绑定token状态查询
          POST
        • 是否可以绑定设备
          POST
        • 设备统计详情
          POST
        • 新增设备
          POST
        • 删除设备
          POST
        • 获取设备列表
          POST
        • 转移设备到新设备上
          POST
        • 批量绑定
          POST
        • 批量导入设备
          POST
        • 批量更新设备
          POST
        • 导入批量更新设备
          POST
        • 获取设备详情
          POST
        • 转让设备
          POST
        • 解绑设备
          POST
        • 更新设备
          POST
      • interact
        • 获取调用设备行为的结果
        • 调用设备行为
        • 请求网关上报拓扑关系
        • 通知网关绑定子设备
        • 批量调用设备属性--废弃
        • 批量调用设备属性
        • 获取调用设备属性的结果
        • 调用设备属性
        • 批量请求设备获取设备最新属性
        • 请求设备获取设备最新属性
        • 发送消息给设备
        • 获取调用设备属性的结果--废弃
        • 调用设备行为--废弃
        • 调用设备属性--废弃
      • msg
        • 获取设备异常日志
        • 获取事件历史记录
        • 获取网关可以绑定的子设备列表
        • 获取云端诊断日志
        • 聚合属性历史记录
        • 获取最新属性记录
        • 获取单个id属性历史记录
        • 批量获取单个id属性历史记录
        • 获取设备sdk日志
        • 获取设备命令日志
        • 获取设备影子列表
        • 获取设备状态日志
      • profile
        • 删除设备配置
        • 获取设备配置列表
        • 获取设备配置详情
        • 更新设备配置
      • module
        • version
          • 获取设备模块版本详情
          • 获取设备模块版本列表
      • schema
        • 创建设备物模型
        • 获取设备物模型列表
        • 批量创建设备物模型
        • 批量删除设备物模型
        • 获取设备物模型tsl
        • 更新设备物模型
      • edge
        • 设备使用http协议用云端交互,需要在http头中带上mqtt的账号密码(basic auth)
      • group
        • 将设备加到多个分组中
        • 删除设备所在分组
        • 更新设备所在分组
    • group
      • device
        • 添加分组设备
        • 删除分组设备
        • 更新分组设备
      • info
        • 创建分组
        • 删除分组
        • 获取分组列表
        • 获取分组详情信息
        • 更新分组信息
    • ota
      • firmware
        • device
          • 取消指定任务下的升级
          • 确认升级设备
          • 查询升级设备列表
          • 重试设备升级
        • info
          • 添加升级包
          • 删除升级包
          • 升级包列表
          • 查询升级包
          • 修改升级包
        • job
          • 创建升级任务
          • 获取升级包下的升级任务批次列表
          • 查询指定升级批次的详情
          • 更新升级批次
      • module
        • info
          • 创建模块
          • 删除模块
          • 获取模块列表
          • 查询模块详情
          • 更新模块
    • product
      • category
        • 新增产品品类
        • 删除产品品类
        • 获取产品品类列表
        • 批量导出产品品类
        • 批量导入产品品类
        • 获取产品品类详情
        • 获取产品品类物模型列表
        • 批量新增产品品类物模型
        • 批量删除产品品类物模型
        • 批量更新产品品类物模型
        • 更新产品品类
      • custom
        • 获取产品自定义信息详情
        • 更新产品自定义信息
      • info
        • 新增产品
        • 删除产品
        • 获取产品信息列表
        • 初始化产品
        • 批量导出产品
        • 批量导入产品
        • 获取产品详情
        • 更新产品
      • remoteConfig
        • 创建配置
        • 获取配置列表
        • 获取最新配置
        • 推送配置
      • schema
        • 创建产品物模型
        • 删除产品物模型
        • 获取产品物模型
        • 批量创建产品物模型
        • 导入产品物模型tsl
        • 获取产品物模型tsl
        • 更新产品物模型
      • config
        • 更新配置
    • protocol
      • info
        • 新增自定义协议
        • 删除自定义协议
        • 获取自定义协议信息列表
        • 获取自定义协议详情
        • 更新自定义协议
      • service
        • 删除自定义协议服务器
        • 获取自定义协议服务器信息列表
      • script
        • device
          • 新增协议脚本设备
          • 删除协议脚本设备
          • 获取协议脚本设备列表
          • 获取协议脚本设备详情
          • 更新协议脚本设备
        • 新增协议脚本
        • 协议脚本调试
        • 删除协议脚本
        • 获取协议脚本列表
        • 批量导出协议脚本
        • 批量导入协议脚本
        • 获取协议脚本详情
        • 更新协议脚本
      • sync
        • 设备同步(如果该协议不支持会返回不支持)
        • 产品同步(如果该协议不支持会返回不支持)
    • rule
      • alarm
        • info
          • 新增告警
          • 删除告警
          • 获取告警信息列表
          • 获取告警信息
          • 更新告警
        • record
          • 处理告警
          • 获取告警记录列表
        • scene
          • 删除告警和场景的关联
          • 获取告警和场景的关联列表
          • 更新告警和场景的关联
      • scene
        • info
          • 新增场景
          • 删除场景
          • 获取场景信息列表
          • 手动触发场景
          • 获取场景信息详情
          • 更新场景
        • log
          • 获取场景日志列表
      • chain(企业版)
        • detail
          • 获取规则链详情
          • 更新规则链详情
        • group
          • 添加规则链分组
          • 删除规则链分组
          • 获取规则链分组列表
          • 获取规则链分组信息
          • 更新规则链分组
        • info
          • 添加规则链
          • 删除规则链
          • 获取规则链列表
          • 获取规则链信息
          • 更新规则链
        • operate
          • 执行规则链
    • schema
      • common
        • 新增通用物模型
        • 删除通用物模型
        • 获取通用物模型列表
        • 初始化通用物模型
        • 批量导出通用物模型
        • 批量导入通用物模型
        • 更新通用物模型
    • slot
      • area
        • 插槽区域创建
        • 插槽区域更新
      • user
        • 插槽用户订阅
    • user
      • device
        • collect
          • 获取收藏设备列表
          • 批量收藏设备
          • 批量取消收藏设备
        • share
          • 分享设备
          • 取消分享设备
          • 获取分享设备列表
          • 接受批量分享设备
          • 生成批量分享设备二维码
          • 批量取消分享设备
          • 获取批量分享的设备列表
          • 获取分享设备详情
          • 更新分享设备信息
  1. info

获取设备详情

POST
/api/v1/things/device/info/read

请求参数

Header 参数

Body 参数application/json

示例
{
    "productID": "string",
    "deviceName": "string",
    "withProperties": [
        "string"
    ],
    "propertyIgnoreEmpty": true,
    "withProfiles": [
        "string"
    ],
    "withOwner": true,
    "withGateway": true,
    "withArea": true
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/things/device/info/read' \
--header 'Ithings-Project-Id: {{Ithings-Project-Id}}' \
--header 'Ithings-Token: {{iThings-token}}' \
--header 'app-code: {{appCode}}' \
--header 'device-id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "productID": "string",
    "deviceName": "string",
    "withProperties": [
        "string"
    ],
    "propertyIgnoreEmpty": true,
    "withProfiles": [
        "string"
    ],
    "withOwner": true,
    "withGateway": true,
    "withArea": true
}'

返回响应

🟢200成功
application/json
A successful response.
Body

示例
{
    "code": "200",
    "msg": "string",
    "data": {
        "id": 0,
        "tenantCode": "string",
        "productID": "string",
        "projectID": "string",
        "productName": "string",
        "deviceType": 0,
        "productImg": "string",
        "areaID": "string",
        "deviceName": "string",
        "deviceAlias": "string",
        "secret": "string",
        "cert": "string",
        "imei": "string",
        "mac": "string",
        "categoryID": 0,
        "version": "string",
        "hardInfo": "string",
        "softInfo": "string",
        "mobileOperator": 10,
        "phone": "string",
        "iccid": "string",
        "position": {
            "longitude": 180,
            "latitude": 90
        },
        "address": "string",
        "adcode": "string",
        "tags": [
            {
                "key": "string",
                "value": "string"
            }
        ],
        "schemaAlias": {},
        "isOnline": 2,
        "firstLogin": "string",
        "firstBind": "string",
        "lastBind": "string",
        "lastLogin": "string",
        "lastOffline": "string",
        "expTime": "string",
        "logLevel": 5,
        "rssi": 0,
        "createdTime": "string",
        "status": 0,
        "isEnable": 0,
        "withProperties": {},
        "protocolConf": [
            {
                "key": "string",
                "value": "string"
            }
        ],
        "subProtocolConf": [
            {
                "key": "string",
                "value": "string"
            }
        ],
        "profiles": {},
        "owner": {
            "userID": "string",
            "userName": "string",
            "email": "string",
            "phone": "string",
            "lastIP": "string",
            "regIP": "string",
            "nickName": "string",
            "headImg": "string",
            "createdTime": "string"
        },
        "ratedPower": 0,
        "netType": 10,
        "needConfirmVersion": "string",
        "userID": "string",
        "lastIp": "string",
        "lastLocalIp": "string",
        "sort": 0,
        "deviceImg": "string",
        "isUpdateDeviceImg": true,
        "file": "string",
        "isUpdateFile": true,
        "desc": "string",
        "distributor": {
            "id": 0,
            "idPath": "string"
        },
        "gateway": {},
        "area": {
            "projectID": "string",
            "areaID": "string",
            "areaName": "string"
        },
        "groups": [
            {
                "id": 0,
                "parentID": 0,
                "name": "string",
                "purpose": "string"
            }
        ],
        "groupPurpose": "string",
        "groupIDs": [
            "string"
        ]
    }
}
修改于 2025-08-29 07:40:12
上一页
导入批量更新设备
下一页
转让设备
Built with