Philips Hue API无法检测灯光及场景问题求助

1. 确认API版本与认证方式是否正确 #

• v1 API：需将用户ID放在路径中，如 GET /api/{userid}/lights，确保请求无认证头冲突。
• v2 API：无需在路径中放用户ID，而是通过请求头 hue-application-key: {userid} 完成认证，正确的设备查询端点为 GET /clip/v2/resource/device 或灯光专属端点 GET /clip/v2/resource/light。

2. 检查用户权限配置 #

创建API用户时，需确保权限覆盖灯光、场景及设备资源。重新创建用户的步骤：

1. 按下Hue桥接器上的配对按钮。
2. 发送POST请求到 http://<bridge-ip>/api，请求体如下：

{
  "devicetype": "your_app_name#your_device",
  "generateclientkey": true,
  "capabilities": {
    "lights": true,
    "scenes": true,
    "devices": true
  }
}

3. 使用返回的新用户ID重新调用API。

3. 验证蓝牙设备与桥接器的连接状态 #

• 在Hue应用中确认Play灯条已通过蓝牙成功连接到桥接器（而非仅直连手机）。
• 进入桥接器设置页面，手动执行「同步设备」操作，等待同步完成后再测试API。

4. 排查API请求细节 #

• 调用v1 API的设备搜索接口时，确保发送的是 POST /api/{userid}/lights 且请求体为空。
• 使用v2 API时，检查请求头是否包含正确的 hue-application-key，避免遗漏导致权限不足返回空列表。

内容的提问来源于stack exchange，提问作者Revox