更新设备信息

更新设备的名称、说明和标签。

请求URL

PUT {base_url}/device/openapi/v1.0/devices

请求参数

表 1. 头部参数
参数 是否必填 类型 描述
Authorization 是 String API调用的有效访问token。

格式为 Bearer {access_token}。
表 2. 主体参数
参数 是否必填 类型 描述
deviceId 是 Integer 设备的唯一标识符，当您添加设备时会返回。
注： 如果您没有保存设备ID，可以使用以下方法查询设备的ID 查询设备列表。
name 是 String 更新设备名称。
description 否 String 更新设备说明。
project 否 String 更新设备标签。

响应参数

参数 类型 描述
data Object<Device_Info> 更新后的设备信息。
status String API的请求结果。
  • Success
  • Failed
requestId String 唯一的请求ID ,可用于快速定位请求。
设备信息
参数 类型 描述
String 设备的SN（序列号）。
deviceId Integer 在星纵物联开放平台上设备唯一的ID。
注： 建议保存此设备ID以备未来使用，因为它通过API管理或配置设备时是必需的要填入的。
devEUI String
注： 根据产品型号的不同，此参数可能不会被返回。
EUI（设备的唯一标识符）。
imei String
注： 根据产品型号的不同，此参数可能不会被返回。
设备IMEI（国际移动设备识别码）号

示例

请求示例
更新ID为"1742010610312101890"的设备的名称和标签。
PUT /device/openapi/v1.0/devices HTTP/1.1
Host: milesight.demo.com
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InllYXN0b25lLWRlZmF1bHQta2V5LWlkIn0.eyJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwic2NvcGUiOlsib3BlbmFwaSJdLCJjbGllbnRfZXh0Ijp7ImFwcF9pZCI6IjE3MzY5NTQ4MDE3MTMzMjgxMzAifSwiZXhwIjoxNzAzMjEzMDk4LCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiJiYjJjN2U4Yy03NGQwLTQ4NjEtODE3MS1iYTc0NWRlMGY0NmQiLCJjbGllbnRfaWQiOiI4OTNkNzdjNy1mMGNiLTRmMzQtOWNhMS03YzJhNGNmMTEzNDgiLCJ0cyI6MTcwMzIwOTQ5ODMzNH0
Content-Type: application/json
User-Agent: OpenAPI

{
    "deviceId": "1742010610312101890",
    "name": "Comfort Sensor Room-3D",
    "project": "Workplace"
}
响应示例
HTTP/1.1 200 OK
{
    "data": {
        "sn": "6785C38073640023",
        "deviceId": "1742010610312101890",
    },
    "status": "Success",
    "requestId": "f3f81c188c03c4b098a83503109802d2"
}