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

# 调用设备属性

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

## Request body

- DeviceInteractSendPropertyReq
  - `data` string, required — 属性数据, JSON格式字符串, 注意字段需要在物模型属性里定义
  - `deviceName` string, required — 设备名
  - `isAsync` boolean — 是否异步操作 异步情况通过获取接口来获取
  - `productID` string, required — 产品id
  - `shadowControl` integer — 设备影子控制 0:自动,当设备不在线的时候设置设备影子,设备在线时直接下发给设备 1:只实时下发,不在线报错 2:如果有设备影子只修改影子,没有的也不下发 3:只修改云端的值 4:只修改云端的值并记录操作日志
  - `syncTimeout` integer — 同步超时时间(单位:秒,不填默认3秒)
  - `withProfile` WithProfile
    - `code` string, required
    - `params` string, required

## Response `200`

A successful response.

- object
  - `code` integer
  - `data` DeviceInteractSendPropertyResp
    - `code` integer, required — 设备返回状态码
    - `msg` string, required — 返回状态
    - `msgToken` string, required — 调用id
  - `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-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)