查询设备物模型

POST

/v2/thing-model/server/{deviceId}

没上报过物模型时，接口返回HTTP状态码204，无body

请求参数

Path 参数

Header 参数

Body 参数application/json

示例

{
  "properties": {
    "key1": 1,
    "key2": 1
  },
  "metadata": {
    "operation": "get"
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/thing-model/server/' \
--header 'X-Tg-App-Id;' \
--header 'Accept-Language;' \
--header 'Authorization;' \
--header 'X-Tg-Signed-Headers;' \
--header 'X-Tg-Date;' \
--header 'X-Tg-Content-Sha256;' \
--header 'X-Tg-Algorithm;' \
--header 'Content-Length;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "properties": {
    "key1": 1,
    "key2": 1
  },
  "metadata": {
    "operation": "get"
  }
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 200,
    "msg": "ok",
    "data": {
        "deviceId": "1702D8OBYWWQ",
        "properties": {
            "temperature": 35.2,
            "humidity": 53
        },
        "metadata": {
            "version": 39
        }
    }
}

🟠400错误

🟠401请登录

🟢204设备状态值不存在

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2025-09-25 14:20:02