联犀-things

批量请求设备获取设备最新属性

POST

/api/v1/things/device/interact/property-get-report-multi-send

things/device/interactthingsDeviceInteract

请求参数

Header 参数

Ithings-Project-Id

string

可选

默认值:

Ithings-Token

string

可选

默认值:

app-code

string

可选

默认值:

device-id

string

可选

用户正在使用的设备ID(小程序,ios,安卓的设备ID)

Body 参数application/json

dataIDs

array[string]

可选

获取的具体标识符的数据如果不指定则获取所有属性数据,一个属性一条

productID

string

产品id

可选

deviceNames

array[string]

设备名

可选

devices

array[object (DeviceCore) {3}]

可选

如果是不同的产品,则传这个字段,上面两个参数填了优先使用

productID

string

产品ID

必需

productName

string

可选

deviceName

string

设备名称

必需

areaID

string

控制一个区域的设备

可选

areaIDPath

string

可选

根据区域路径控制设备

groupID

string

控制一个组的设备

可选

示例

{
  "dataIDs": [
    "string"
  ],
  "productID": "string",
  "deviceNames": [
    "string"
  ],
  "devices": [
    {
      "productID": "string",
      "productName": "string",
      "deviceName": "string"
    }
  ],
  "areaID": "string",
  "areaIDPath": "string",
  "groupID": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v1/things/device/interact/property-get-report-multi-send' \
--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 ''

返回响应

🟢200成功

application/json

A successful response.

Body

code

integer

返回code

可选

默认值:

200

msg

string

返回的消息

可选

data

object (DeviceInteractPropertyGetReportMultiSendResp)

可选

list

array[object (DeviceInteractPropertyGetReportSendMsg) {9}]

必需

批量设备返回结果列表

示例

{
  "code": "200",
  "msg": "string",
  "data": {
    "list": [
      {
        "code": 0,
        "msg": "string",
        "msgToken": "string",
        "timestamp": 0,
        "params": "string",
        "productID": "string",
        "deviceName": "string",
        "sysCode": 0,
        "sysMsg": "string"
      }
    ]
  }
}

修改于 2025-03-25 08:05:06