更新设备属性

更新设备的属性。

请求URL

PATCH {base_url}/device/openapi/v1.0/devices/{deviceId}/properties

请求参数

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

格式为 Bearer {access_token}

2. 路径参数
参数 是否必填 类型 描述
deviceId Integer 设备的唯一标识符,当您添加设备时会返回。
注: 如果您没有保存设备ID,可以使用以下方法查询设备的ID 查询设备列表
3. 主体参数
参数 是否必填 类型 描述
properties Object 需要更新的属性。

要查看不同设备的可配置属性,请参考属性配置

响应参数

参数 类型 描述
data Object<Properties_Info> 更新的属性信息。
status String API的请求结果。
  • Success
  • Failed
requestId String 唯一的请求ID ,可用于快速定位请求。
属性信息
参数 类型 描述
properties Object 成功更新的属性。

示例

请求示例
更新设备ID为"1748256426492760066"的数据报告间隔为30分钟。
PATCH /device/openapi/v1.0/devices/1748256426492760066/properties HTTP/1.1
Host: milesight.demo.com
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InllYXN0b25lLWRlZmF1bHQta2V5LWlkIn0.eyJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwic2NvcGUiOlsib3BlbmFwaSJdLCJjbGllbnRfZXh0Ijp7ImFwcF9pZCI6IjE3MzY5NTQ4MDE3MTMzMjgxMzAifSwiZXhwIjoxNzAzMjEzMDk4LCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiJiYjJjN2U4Yy03NGQwLTQ4NjEtODE3MS1iYTc0NWRlMGY0NmQiLCJjbGllbnRfaWQiOiI4OTNkNzdjNy1mMGNiLTRmMzQtOWNhMS03YzJhNGNmMTEzNDgiLCJ0cyI6MTcwMzIwOTQ5ODMzNH0
Content-Type: application/json
User-Agent: OpenAPI

{
    "properties": {
        "reporting_interval": {    
            "time": 30
        }
    }
}
响应示例
HTTP/1.1 200 OK
{
    "data": {
        "properties": {
            "reporting_interval": {
                "time": 30
            }
        }
    },
    "status": "Success",
    "requestId": "d820fb189824a8809d74f76ebd02363a"
}