保存用户报警配置

POST

/index.php

用于保存用户报警配置。

需要认证：在查询参数 key 或请求体 api_key 中传入用户 API Key；要求会话的接口还需传入 session_token。

请求可使用 JSON（Content-Type: application/json）或表单编码；字段含义、必填性和示例以本接口定义为准。

可能的失败结果

HTTP 状态	errno	英文错误信息	中文释义
400	`400004`	A parameter format is invalid.	参数格式无效。
401	`401002`	The API key is invalid.	API Key 无效。
403	`403001`	Permission is denied for this operation.	无权执行此操作。
409	`409001`	The device is already bound to another user.	设备已绑定给其他用户。
500	`500001`	A database operation failed.	数据库操作失败。

所有响应均包含 request_id，排查问题时请一并提供该值。

请求参数

Authorization

API Key

在 query 添加参数

key

示例：

key: ********************

Query 参数

Body 参数application/json必填

示例

{
    "key": "string",
    "user_id": 0,
    "product_id": "string",
    "device_secret": "string",
    "alarm_items": [],
    "device_controls": [],
    "page_config": {}
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://qiuxian.net.cn//index.php?route=api%2Fuser_alarm_config%2Fsave&key=%3Capi-key%3E' \
--header 'Content-Type: application/json' \
--data '{
    "key": "string",
    "user_id": 0,
    "product_id": "string",
    "device_secret": "string",
    "alarm_items": [],
    "device_controls": [],
    "page_config": {}
}'

返回响应

🟢200

请求处理成功

该响应没有 Body

🟠400

🟠401

🟠403

🟠409

🔴500

修改于 2026-10-20 12:34:11

获取用户报警记录

ErrorResponse

保存用户报警配置

可能的失败结果#

请求参数

请求示例代码

返回响应

可能的失败结果