更新设备

POST

/api/v1/things/device/info/update

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

productID

string

产品id

必需

不可修改

deviceName

string

设备名称

必需

不可修改

secret

string

设备秘钥

必需

cert

string

设备证书

必需

imei

string

IMEI信息

必需

mac

string

MAC信息

必需

version

string

固件版本

必需

hardInfo

string

模组硬件型号

必需

softInfo

string

模组软件版本

必需

position

object

设备定位

可选

longitude

integer

必需

latitude

integer

必需

address

string

详细地址

可选

tags

array [object {2}]

可选

key

string

必需

value

string

必需

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

可选

示例

{
  "productID": "26gvWbvywJq",
  "deviceName": "照向上结深",
  "projectID": "1762544469008695296",
  "areaID": "1763713043102765056",
  "cert": "et veniam tempor anim",
  "imei": "qui ea",
  "mac": "dolore Ut",
  "hardInfo": "dolor dolore pariatur",
  "softInfo": "eiusmod Ut minim",
  "tags": [
    {
      "key": "ipsum Lorem Excepteur adipisicing ullamco",
      "value": "laboris dolor minim"
    },
    {
      "key": "qui",
      "value": "laboris ut tempor"
    },
    {
      "key": "esse nostrud sed",
      "value": "voluptate et mollit veniam Duis"
    },
    {
      "key": "dolore reprehenderit",
      "value": "ullamco consectetur eu quis qui"
    }
  ],
  "logLevel": 48,
  "address": "西藏自治区内江市永胜县",
  "position": {
    "longitude": 25,
    "latitude": 28
  }
}

示例代码

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/info/update' \
--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": "照向上结深",
    "projectID": "1762544469008695296",
    "areaID": "1763713043102765056",
    "cert": "et veniam tempor anim",
    "imei": "qui ea",
    "mac": "dolore Ut",
    "hardInfo": "dolor dolore pariatur",
    "softInfo": "eiusmod Ut minim",
    "tags": [
        {
            "key": "ipsum Lorem Excepteur adipisicing ullamco",
            "value": "laboris dolor minim"
        },
        {
            "key": "qui",
            "value": "laboris ut tempor"
        },
        {
            "key": "esse nostrud sed",
            "value": "voluptate et mollit veniam Duis"
        },
        {
            "key": "dolore reprehenderit",
            "value": "ullamco consectetur eu quis qui"
        }
    ],
    "logLevel": 48,
    "address": "西藏自治区内江市永胜县",
    "position": {
        "longitude": 25,
        "latitude": 28
    }
}'

返回响应

🟢200成功

application/json

Body

code

integer | null

返回code

必需

msg

string

返回消息

必需

默认值:

success

示例

{
  "code": 100006,
  "msg": "检查区域不存在"
}

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