执行自动化场景

POST

/index.php

用于执行自动化场景。

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

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

可能的失败结果

HTTP 状态	errno	英文错误信息	中文释义
500	`500`	An internal server error occurred.	发生内部服务器错误。
400	`400001`	A required parameter is missing.	缺少必填参数。
403	`403001`	Permission is denied for this operation.	无权执行此操作。
403	`403003`	The IP address is blocked.	IP 地址已被拦截。
404	`404001`	The user was not found.	用户不存在。
429	`429004`	The request was blocked by CC attack protection.	请求被 CC 攻击防护拦截。
500	`500001`	A database operation failed.	数据库操作失败。

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

请求参数

Authorization

API Key

在 query 添加参数

key

示例：

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

Query 参数

Body 参数application/json必填

示例

{
    "api_key": "string",
    "product_id": "string",
    "device_secret": "string",
    "scene_name": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://qiuxian.net.cn//index.php?route=api%2Fautomation%2Fexecute_automation&key=%3Capi-key%3E' \
--header 'Content-Type: application/json' \
--data '{
    "api_key": "string",
    "product_id": "string",
    "device_secret": "string",
    "scene_name": "string"
}'

返回响应

🟢200

请求处理成功

该响应没有 Body

🟠400

🟠403

🟠404

🟠429

🔴500

修改于 2026-10-21 06:06:13

保存用户自动化配置

获取用户报警配置

执行自动化场景

可能的失败结果#

请求参数

请求示例代码

返回响应

可能的失败结果