更新事件推送开关

POST

/v2/cloud/switcher/{device_id}

如果全关，global_status=false，tag传空；

如果开启N个或全部，global_status=true, tag传入所有需要打开的tag类型。比如motion,body,sound等该设备支持的事件类型。

请求参数

Path 参数

Header 参数

Body 参数application/json

示例

{
    "global_status": false,
    "tag": [
        "sound"
    ],
    "undisturbed": {
        "status": true,
        "start": "07:00",
        "end": "22:00"
    },
    "interval": 60
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/cloud/switcher/1702D8OBYWWQ' \
--header 'X-Tg-App-Id: xxx' \
--header 'X-Tg-Platform: {{platform}}' \
--header 'X-Tg-Sdk-Version: 23910000' \
--header 'X-Tg-App-Store: {{appstore}}' \
--header 'X-Tg-App-Version: {{app_version}}' \
--header 'X-Tg-App-Pkgname: {{pkgname}}' \
--header 'X-Tg-Date: {{currentUTCTime}}' \
--header 'Accept-Language: zh-CN' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "global_status": false,
    "tag": [
        "sound"
    ],
    "undisturbed": {
        "status": true,
        "start": "07:00",
        "end": "22:00"
    },
    "interval": 60
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "msg": "string"
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2026-01-15 02:33:55

查询事件标签列表

批量查询事件推送开关