批量调用设备属性

开发中

POST

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

iThings-apisvr/物联网相关接口/设备/设备交互

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

Header 参数

iThings-token

string

可选

示例值:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVaWQiOiIxNzQwMzU4MDU3MDM4MTg4NTQ0IiwiZXhwIjoxNjgzNTQ4NDU5LCJpYXQiOjE2ODM1NDQ4NTksIlJvbGUiOjF9.ygQyxFx7AGtf7vcFJmE-xcElQUtwE23HN_0av02tSec

iThings-project-id

string

可选

默认值:

123123123

Body 参数application/json

areaID

string

项目区域id

可选

传了优先从项目区域中获取设备列表

groupID

string

分组ID

可选

传了会从分组下获取设备

productID

string

产品id

可选

deviceNames

array[string]

设备名列表

可选

data

string

属性数据

必需

JSON格式字符串, 注意字段需要在物模型属性里定义

shadowControl

integer

设备影子控制

必需

0:自动,当设备不在线的时候设置设备影子,设备在线时直接下发给设备 1:只实时下发,不在线报错 2:如果有设备影子只修改影子,没有的也不下发

示例

{
    "areaID": "string",
    "groupID": "string",
    "productID": "string",
    "deviceNames": [
        "string"
    ],
    "data": "string",
    "shadowControl": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://42.193.250.251:7777/api/v1/things/device/interact/multi-send-property' \
--header 'iThings-token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVaWQiOiIxNzY2MjUyMTY2OTI5NjEyODAwIiwiUm9sZSI6NSwiSXNBbGxEYXRhIjoyLCJleHAiOjE2ODcwMTUyMDYsImlhdCI6MTY4NzAwOTMxMn0.xxFiBpYlTIDLYhN-_stlrmYGOLqF-wHJKBSqs-zVb8k' \
--header 'iThings-project-id: 123123123' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
    "areaID": "string",
    "groupID": "string",
    "productID": "string",
    "deviceNames": [
        "string"
    ],
    "data": "string",
    "shadowControl": 0
}'

返回响应

🟢200成功

application/json

Body

code

integer | null

返回code

必需

msg

string

返回消息

必需

默认值:

success

data

object

必需

list

array [object {5}]

必需

示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "list": [
            {
                "sysCode": 0,
                "sysMsg": "string",
                "clientToken": "string",
                "code": 0,
                "status": "string"
            }
        ]
    }
}

修改于 2023-06-18 13:44:36