---
title: "批量调用设备属性"
method: POST
path: "/api/v1/things/device/interact/property-control-multi-send"
tags: ["things/device/interact", "thingsDeviceInteract"]
---

# 批量调用设备属性

`POST /api/v1/things/device/interact/property-control-multi-send`

## Request body

- DeviceInteractMultiSendPropertyReq
  - `areaID` string — 项目区域id,传了优先从项目区域中获取设备列表
  - `areaIDPath` string — 根据区域路径控制设备
  - `data` string, required — 属性数据, JSON格式字符串, 注意字段需要在物模型属性里定义
  - `deviceNames` string[] — 设备名列表
  - `devices` DeviceCore[] — 如果是不同的产品,则传这个字段,上面两个参数填了优先使用
    - `deviceName` string, required — 设备名称
    - `productID` string, required — 产品ID
    - `productName` string
  - `groupID` string — 分组ID,传了会从分组下获取设备
  - `isAsync` boolean — 是否异步操作 异步情况通过获取接口来获取
  - `productID` string — 产品id
  - `shadowControl` integer — 设备影子控制 0:自动,当设备不在线的时候设置设备影子,设备在线时直接下发给设备 1:只实时下发,不在线报错 2:如果有设备影子只修改影子,没有的也不下发
  - `syncTimeout` integer — 同步超时时间(单位:秒,不填默认3秒)

## Response `200`

A successful response.

- object
  - `code` integer
  - `data` DeviceInteractMultiSendPropertyResp
    - `list` DeviceInteractMultiSendPropertyMsg[], required — 批量设备返回结果列表
      - `code` integer, required — 设备返回状态码
      - `deviceName` string, required — 设备名
      - `msg` string, required — 返回状态
      - `msgToken` string, required — 调用id
      - `productID` string, required — 产品id
      - `sysCode` integer, required — 系统错误码
      - `sysMsg` string, required — 系统错误信息
  - `msg` string

## Changes

- **2026-03-27** `b9582d0ab6af` — 1 breaking, 1 info
  - added required request body
  - added the media type `application/json` for the response with the status `200`
- **2025-03-14** `e87dbcac5d9e` — 2 breaking
  - removed the request body
  - removed the media type `application/json` for the response with the status `200`

[Change history](https://skmtc.dev/unitedrhino/apis/things-api/changes/api/v1/things/device/interact/property-control-multi-send/post.md)

---

[API](https://skmtc.dev/unitedrhino/apis/things-api.md) · [All operations](https://skmtc.dev/unitedrhino/apis/things-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unitedrhino/things-api/revisions/f3bdeb916389/schema)