Sonos SMAPI集成问题咨询：HTTP端点不支持及无请求流量

一、为何HTTP端点不被Sonos接受？ #

• SMAPI强制安全规范：Sonos为保障设备控制、用户数据传输的安全性，要求所有集成必须使用HTTPS协议，HTTP明文传输存在数据泄露风险，因此在服务配置验证阶段会直接拦截HTTP端点，抛出JsonValidatorPropertyValueError错误。
• 配置Schema硬限制：SMAPI的服务配置JSON Schema中，端点URL字段明确限定为HTTPS协议，不符合该规则的配置会直接触发验证失败，这是官方设定的不可绕过的规则。

二、HTTPS集成成功后无请求流量的可能原因 #

• 证书信任问题：Sonos设备仅信任受权威CA颁发的有效证书，自签证书（除非在开发者模式下手动添加信任）会被设备拒绝，导致请求被静默丢弃，无流量产生。
• TLS版本不兼容：Sonos设备仅支持TLS 1.2及以上版本的加密协议，若服务端配置了TLS 1.0/1.1等旧版本，设备无法建立安全连接，不会发送请求。
• 端点路径/方法不匹配：SMAPI请求有严格的路径和HTTP方法要求（如回调端点需指定特定路径、使用POST方法），若服务端未按文档要求配置，设备发送请求后无法得到正确响应，可能停止重试导致无流量。
• 域名解析异常：即使在同一网络，Sonos设备可能使用预设DNS服务器，若你的端点域名解析结果与实际服务IP不符，设备无法定位服务端，进而无请求发送。
• 未启用设备日志排查：Sonos开发者后台提供设备日志功能，开启后可查看设备请求的具体状态（如连接超时、证书错误），这是定位问题最有效的方式。

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