联犀-things

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

POST

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

things/device/interactthingsDeviceInteract

请求参数

Header 参数

Ithings-Project-Id

string

可选

默认值:

Ithings-Token

string

可选

默认值:

app-code

string

可选

默认值:

device-id

string

可选

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

Body 参数application/json

productID

string

产品id (必填)

必需

deviceName

string

设备名(必填)

必需

dataIDs

array[string]

可选

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

示例

{
  "productID": "string",
  "deviceName": "string",
  "dataIDs": [
    "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-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 (DeviceInteractPropertyGetReportSendResp)

可选

code

integer <int64>

设备返回状态码

必需

msg

string

返回状态

必需

msgToken

string

调用id

必需

timestamp

integer <int64>

必需

上报时间戳(毫秒时间戳)

params

string

获取到的值

必需

示例

{
  "code": "200",
  "msg": "string",
  "data": {
    "code": 0,
    "msg": "string",
    "msgToken": "string",
    "timestamp": 0,
    "params": "string"
  }
}

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