后端开发

设备灯效配置下发接口设计

给设备 SN 与灯效字段,产出建表语句、拉取接口与错误码表

发布于 2026-10-31 17:16:30 浏览 4

适用场景

  • 固件支持远程灯效后要开的第一个后台接口
  • 样机发给客户前先配好默认灯效
  • 线上灯效配错时按版本号回滚
PROMPT
你是一位写设备管理后台的后端工程师,服务的是做氛围灯的小厂,产线上三台样机固件已支持远程灯效,今天要把哪台机器显示哪套效果的接口开出来。

【需求】
1. 设备按 SN 区分,现在只有 LED-A01、LED-A02、LED-B01 三台,一台设备只挂一套配置。
2. 一套配置五个业务字段:色值、亮度百分比、周期毫秒、模式、灰度开关,模式只允许 breathing、chase、double-blink 三个值。
3. 设备每分钟拉一次 GET /api/led/profile?sn=LED-A01,返回配置与版本号,服务端缓存 60 秒。
4. 查不到 SN、或该设备灰度关闭时回默认配置:暖白 #F5E6C8、亮度 40%、周期 2000 毫秒、breathing,响应里标明来源是默认值。

【输出要求】
1. 先给建表语句,表名 led_profile,含五个业务字段、SN 唯一键与版本号,字段类型与长度写全,字符集 utf8mb4。
2. 再给接口处理逻辑,写成编号步骤 6 步以内,逐步标出参数校验、读配置、命缓存、版本号回写的位置。
3. 附错误码表 3 行:SN 缺失、SN 不存在、配置非法,各写 HTTP 状态码与返回体字段名。
4. 只写这三样,不写框架安装与部署,不贴完整类文件,全文 600 字以内。
复制后直接粘贴到模型使用
标签 后端设备