获取设备详情 - iThings(归档-不使用)

请求参数

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

productID

string

产品id

必需

为空时获取所有产品

deviceName

string

必需

withProperties

array[string] | null

获取设备最新属性

可选

如果不为nil,如果为空,获取设备所有最新属性如果传了属性列表,则会返回属性列表

示例

{
  "productID": "26gvWbvywJq",
  "deviceName": "者高建事置南"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://42.193.250.251:7777/api/v1/things/device/info/read' \
--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 '{
    "productID": "26gvWbvywJq",
    "deviceName": "者高建事置南"
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

msg

string

必需

data

object (设备信息)

必需

productID

string

产品id

必需

不可修改

deviceName

string

设备名称

必需

不可修改

secret

string

设备秘钥

必需

cert

string

设备证书

必需

imei

string

IMEI信息

必需

mac

string

MAC信息

必需

version

string

固件版本

必需

hardInfo

string

模组硬件型号

必需

softInfo

string

模组软件版本

必需

position

object

设备定位

可选

address

string

详细地址

可选

tags

array [object {2}]

可选

isOnline

integer

在线状态

可选

1离线 2在线只读

firstLogin

string

激活时间

可选

lastLogin

string

最后上线时间

可选

logLevel

integer

日志级别

可选

1)关闭 2)错误 3)告警 4)信息 5)调试

createdTime

string

创建时间

可选

withProperties

object

获取的属性列表,如果不传withProperty,则不会返回

可选

key是属性id,value是{"value:"xxx","timestamp":123}的结构体,时间戳是毫秒时间戳

deviceAlias

string

设备别名

可选

projectID

string

项目id

可选

areaID

string

项目区域id

可选

示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "productID": "26gvWbvywJq",
    "projectID": 1762544445298294800,
    "areaID": 1763335225737846800,
    "deviceName": "者高建事置南",
    "secret": "8/lx/hhMsSxaeTmM4tU5ipmVZ2k=",
    "cert": "",
    "imei": "",
    "mac": "",
    "version": "",
    "hardInfo": "",
    "softInfo": "",
    "position": {
      "longitude": 25,
      "latitude": 28
    },
    "address": "西藏自治区内江市永胜县",
    "tags": [
      {
        "key": "dolore reprehenderit",
        "value": "ullamco consectetur eu quis qui"
      },
      {
        "key": "esse nostrud sed",
        "value": "voluptate et mollit veniam Duis"
      },
      {
        "key": "ipsum Lorem Excepteur adipisicing ullamco",
        "value": "laboris dolor minim"
      },
      {
        "key": "qui",
        "value": "laboris ut tempor"
      }
    ],
    "isOnline": 2,
    "firstLogin": "0",
    "lastLogin": "0",
    "logLevel": 48,
    "createdTime": "1683367891"
  }
}