1. 设备控制
秋羡物联网IoT云平台 API
  • 账号与认证
    • 用户登录
      POST
    • 用户注册
      POST
    • 发送验证码（扩展版）
      POST
    • 获取用户信息
      GET
    • 更新用户信息
      POST
    • 上传头像
      POST
    • 更新头像URL
      POST
    • 忘记密码/重置密码
      POST
    • 检查二次验证待处理
      GET
    • 提交二次验证结果
      POST
    • 注销账号
      POST
    • 获取用户产品列表
      POST
    • 获取平台政策
      GET
    • 完成异地登录验证
      POST
    • 创建扫码登录会话
      POST
    • 查询扫码登录状态
      GET
    • 查询扫码登录详情
      GET
    • 确认扫码登录
      POST
    • 拒绝扫码登录
      POST
    • 取消扫码登录
      POST
    • 创建快捷登录请求
      POST
    • 查询待处理快捷登录请求
      GET
    • 确认快捷登录请求
      POST
    • 拒绝快捷登录请求
      POST
    • 查询快捷登录状态
      GET
    • 修改账号邮箱
      POST
    • 修改账号密码
      POST
    • 强制下线登录设备
      POST
    • 校验登录会话
      GET
    • 获取登录设备列表
      GET
  • 设备接入与管理
    • 获取设备列表
    • 获取产品物模型定义
    • 获取设备物模型数据
    • 绑定设备
    • 获取设备影子
    • 批量获取设备影子
    • HTTP设备数据上报
    • 解绑设备
    • 获取产品物模型列表
    • 获取物模型详情
    • 获取命令日志
    • 获取设备影子（通过设备ID）
    • 获取数据点
    • 获取用户设备列表
    • 计算室内空气质量指数（IAQI）
    • 获取设备物模型
    • 获取产品配网识别信息
    • 获取用户产品及设备
  • 设备控制
    • 设置设备属性
      POST
    • 获取设备属性
      POST
    • MQTT消息发布
      POST
    • 查询设备属性
      POST
    • 执行展示控制卡片
      POST
  • 通知与消息
    • 发送邮件通知
    • 发送站内信
    • 获取站内信列表
    • 标记消息已读
    • 标记单条消息已读
  • 健康与用药
    • 健康档案概览
    • 健康趋势数据
    • 更新健康档案
    • 添加健康事件
    • 更新健康事件
    • 获取健康事件列表
    • 删除健康事件
    • 获取所有健康趋势数据
    • 获取健康报告列表
    • 获取报告详情
    • 生成健康报告
    • 获取健康评分
    • 获取雷达图数据
    • 获取用药提醒列表
    • 添加用药提醒
    • 更新用药提醒
    • 删除用药提醒
    • 切换用药提醒状态
    • 获取今日待服药列表
    • 确认服药或跳过
    • 获取服药记录
    • 获取服药统计
    • 轮询设备服药提醒
    • 关闭设备服药提醒
    • 获取药品库存
    • 添加药品库存
    • 更新药品库存
    • 删除药品库存
  • AI与数据分析
    • 健康预测
    • AI智能客服对话
    • 环境健康耦合计算
    • 获取AI模型列表（客户端用）
    • 测试AI报警分析
  • 平台服务
    • IP定位
    • 检查功能使用限制
    • 获取服务器时间
    • 获取网站配置
    • 增加使用次数
    • 获取限制配置字段
    • 获取天气数据
  • 展示与固件
    • 获取产品展示配置（含用户个性化覆盖）
    • 保存当前用户的个性化卡片布局
    • 恢复管理员默认卡片布局
    • 检查OTA固件更新
    • 下载OTA固件
    • 上报OTA升级结果
  • 习惯学习
    • 获取习惯建议
    • 获取习惯统计概览
    • 获取用户活跃时间分布
    • 获取产品列表
    • 获取产品下的设备列表
    • 获取用户设备列表
    • 开始习惯学习
    • 停止学习任务
    • 获取学习状态
    • 预测用户活跃时间
    • 获取预测时段
    • 验证活跃时间预测
    • 提交预测反馈
    • 导出MCU模型
    • 删除习惯学习模型
    • 启动认知习惯学习
    • 获取习惯学习目录
    • 保存习惯学习范围
    • 获取聚合习惯分布
    • 获取可学习用户
    • 获取聚合唤醒预测
  • 设备共享
    • 共享设备
    • 搜索用户
    • 获取我的设备（含共享信息）
    • 撤销设备共享
    • 解绑设备（共享模块）
    • 获取所有设备及共享信息
    • 获取设备共享列表
    • 移除共享设备（被授权方操作）
    • 共享产品
    • 获取产品共享记录
    • 撤销产品共享
    • 解绑产品
    • 解除被共享产品
  • 报警与自动化
    • 获取报警历史
    • 获取报警模板
    • 获取报警模板产品列表
    • 获取报警页面配置
    • 获取设备控制配置
    • 获取AI数据超时配置
    • 保存报警模板
    • 从物模型导入报警模板
    • 保存报警页面配置
    • 保存设备控制配置
    • 保存AI数据超时配置
    • 获取自动化可用设备
    • 获取自动化物模型
    • 获取自动化条件
    • 获取自动化动作
    • 获取用户自动化配置
    • 保存自动化条件配置
    • 保存自动化动作配置
    • 保存用户自动化配置
    • 执行自动化场景
    • 获取用户报警配置
    • 获取用户报警记录
    • 保存用户报警配置
  • 数据模型
    • ErrorResponse
    • SuccessResponse
  1. 设备控制

设置设备属性

POST
/index.php
用于设置设备属性。
认证要求以参数说明为准；未标记认证的接口仍可能受到访问频率和安全策略限制。
请求可使用 JSON（Content-Type: application/json）或表单编码；字段含义、必填性和示例以本接口定义为准。

可能的失败结果#

HTTP 状态errno英文错误信息中文释义
500500An internal server error occurred.发生内部服务器错误。
400400001A required parameter is missing.缺少必填参数。
400400004A parameter format is invalid.参数格式无效。
400400011A device control parameter is invalid.设备控制参数无效。
401401002The API key is invalid.API Key 无效。
403403003The IP address is blocked.IP 地址已被拦截。
403403004The device does not belong to the current user.该设备不属于当前用户。
403403006Permission is denied for this AI model.无权使用该 AI 模型。
404404002The device was not found.设备不存在。
429429004The request was blocked by CC attack protection.请求被 CC 攻击防护拦截。
502502002The MQTT service request failed.MQTT 服务请求失败。
所有响应均包含 request_id，排查问题时请一并提供该值。

请求参数

Query 参数

Body 参数application/json必填

示例
{
    "api_key": "your_key",
    "product_id": "P001",
    "device_secret": "SEC001",
    "params": {
        "LedCmd": "LED_ON"
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://qiuxian.net.cn//index.php?route=api%2Fthingmodel%2Fset-device-property' \
--header 'Content-Type: application/json' \
--data '{
    "api_key": "your_key",
    "product_id": "P001",
    "device_secret": "SEC001",
    "params": {
        "LedCmd": "LED_ON"
    }
}'

返回响应

🟢200
application/json
控制命令已下发
Bodyapplication/json

示例
{
    "errno": 0,
    "message": "控制命令已下发"
}
🟠400
🟠401
🟠403
🟠404
🟠429
🔴500
🔴502
修改于 2026-10-21 06:06:13
上一页
获取用户产品及设备
下一页
获取设备属性
Built with