{
  "added_at": "2026-11-08",
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "qss-switch-api reconstructs access to the private REST interface of a QNAP QSS-managed switch from its web UI JavaScript. Its Python CLI logs in, reads port, PoE, sensor and LLDP telemetry, and can send explicit API calls; the documentation records bearer-token authentication and response fields.",
  "description_zh": "qss-switch-api 根据 QNAP QSS 网页界面的 JavaScript 重建交换机私有 REST 接口。其 Python CLI 可登录、读取端口、PoE、传感器和 LLDP 数据，也可发送指定 API 调用；文档记录 Bearer Token 认证及响应字段。",
  "entry_url": "https://awesomerea.org/resources/qss-switch-api-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/qss-switch-api-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/Gotham-Sound/qss-switch-api/blob/3a89625ee17e3ed191f61e880f696ec81e7823d2/README.md",
  "group": "cases",
  "id": "qss-switch-api-case",
  "json_url": "https://awesomerea.org/resources/qss-switch-api-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/qss-switch-api-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/qss-switch-api-case/index.md",
  "name": "qss-switch-api: reconstructing QNAP QSS switch control",
  "name_zh": "qss-switch-api：重建 QNAP QSS 交换机控制接口",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "scope",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "QNAP QSS-managed switch; documented validation covers QSW-M2106PR-2S2T firmware 1.2.1.",
    "Python 3.8+; PyYAML is optional for YAML configuration.",
    "Write requests require explicit confirmation and can disrupt switch configuration.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 QNAP QSS 管理型交换机；文档中的验证机型为运行 1.2.1 固件的 QSW-M2106PR-2S2T。",
    "需要 Python 3.8 或更新版本；使用 YAML 配置时可选装 PyYAML。",
    "写入请求需要明确确认，可能影响交换机配置。",
    "采用 MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/Gotham-Sound/qss-switch-api",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}