# qss-switch-api：重建 QNAP QSS 交换机控制接口

> qss-switch-api 根据 QNAP QSS 网页界面的 JavaScript 重建交换机私有 REST 接口。其 Python CLI 可登录、读取端口、PoE、传感器和 LLDP 数据，也可发送指定 API 调用；文档记录 Bearer Token 认证及响应字段。

- 类型：案例
- 目标：协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-11-06
- 收录于：2026-11-08
- 原始资源：<https://github.com/Gotham-Sound/qss-switch-api>
- 一手来源：<https://github.com/Gotham-Sound/qss-switch-api/blob/3a89625ee17e3ed191f61e880f696ec81e7823d2/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/qss-switch-api-case/>
- 记录 JSON：<https://awesomerea.org/resources/qss-switch-api-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/qss-switch-api-case/index.md)

## 使用条件与局限

- **前提条件：**需要 Python 3.8 或更新版本；使用 YAML 配置时可选装 PyYAML。
- **范围：**需要 QNAP QSS 管理型交换机；文档中的验证机型为运行 1.2.1 固件的 QSW-M2106PR-2S2T。
- **局限：**写入请求需要明确确认，可能影响交换机配置。
- **许可：**采用 MIT 许可证。

## 一手来源

1. <https://github.com/Gotham-Sound/qss-switch-api/blob/3a89625ee17e3ed191f61e880f696ec81e7823d2/README.md>

## 同分区更多条目：协议

- [NameLand：重建 Casio KL-A45 串口打印通信](https://awesomerea.org/zh/resources/nameland-case/index.md) · 案例
- [dh360d：重建 Darkflash 散热器 LCD 通信协议](https://awesomerea.org/zh/resources/dh360d-case/index.md) · 案例
- [Sony WH-CH720N：重建 RFCOMM 耳机控制协议](https://awesomerea.org/zh/resources/sony-wh-ch720n-linux-case/index.md) · 案例
- [Kosmos CP1：重建 CP2 磁带格式](https://awesomerea.org/zh/resources/kosmos-cp1-cassette-case/index.md) · 案例
- [ISDT PB40：重建移动电源 BLE 协议](https://awesomerea.org/zh/resources/pb40-bluetooth-case/index.md) · 案例
- [Jacuzzi JB1HL：解析 J185 面板通信总线](https://awesomerea.org/zh/resources/jacuzzi-jb1hl-protocol-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。