兼容候选#

本页登记 /v1/general 与 /v1/public 族中与零售 App 无关或无 App 现役证据的 8 个端点的归属结论：5 个非 app 端点（设备固件向 4 + 运维诊断向 1）不占零售手册正文；3 个与 web 共用端点以链接机构正本页的方式覆盖、不计为「App 现役」证据。归属依据为后端源码核验 + web 仓库调用图旁证（手机 app 源码不在工作区，8 个端点的旧 app 文档收录数为 0）。统计口径见覆盖总览。

与 web 共用（3 项）#

这 3 个端点有 web 现役调用图且机构手册已有正本页；零售 App 如需使用，以机构正本页（及其链接的清单层）为契约出处：

端点	Web 现役调用	鉴权	机构正本页
GET /main-service/main-api/v1/general/configuration/base/getCloudServiceInfo	web 设备 / 采集服务器管理 6 个页面（_index/add/edit 的下拉选项与表单默认值）	匿名白名单	查询云服务节点信息
GET /main-service/main-api/v1/general/device/data-acquisition-device/listDeviceNos	web 共享「设备号选择器」展开时拉取	不在白名单，需登录态	枚举文件存储设备号
GET /main-service/main-api/v1/general/device/data-acquisition-device/listFilesByDeviceNoAndType	web 设备文件备份页加载列表	不在白名单，需登录态	按设备与类型列出设备文件

非 app（5 项）#

端点	面向	一句话依据	去向
POST /main-service/main-api/v1/general/device/data-acquisition-device/uploadByDeviceNo	设备固件	上传 URL + 混淆码 + ts 由 device-service 经 MQTT retrieve upload/* 应答下发给设备（附带校验值；该值的生成算法属于内部实现，不在文档披露范围，具体生成方式请与开发人员沟通确认），固件无需也无处硬编码该路径	机构手册已从设备遥控视角覆盖：转发取回项（data.upload/<category> 应答项即本端点的 URL/ts/oc）
GET /main-service/main-api/v1/general/device/data-acquisition-device/getDeviceData	设备固件	设备以 deviceNo + 附带校验值查询自己被分配的云服务节点（domain/ip/nodeRole），节点引导语义；web / 固件仓 / 旧 app 文档零消费	无正本，不发布（设备侧自引导语义，非 App 功能面）
GET /main-service/main-api/v1/general/device/data-acquisition-device/getServerTime	设备固件辅助	与 getDeviceData 同提交成对加入，为两个 token 端点的 ±30 分钟时间窗提供时钟同步；无任何 web / app 消费	无正本，不发布（固件时钟源）
GET /main-service/main-api/v1/public/firmware/latest	设备固件	入参 devType+cpuId、硬编码 scm 租户、解码固件二进制头返回升级信息，纯固件升级检查；device-service 另有同数据源的 MQTT retrieve firmware 孪生通道	无正本，不发布；机构手册仅覆盖管理侧固件包 CRUD（固件包资源节），非本公网检查端点
GET /main-service/main-api/v1/general/configuration/base/getClientIp	运维诊断	引入提交自述「用于调试和验证客户端 IP 检测功能」，全工作区（web / 固件 / 旧 app 文档）无业务消费方	无正本，不发布（运维诊断工具）

归属边界说明#

• 白名单与登录边界：上述 8 个端点中 6 个在匿名放行清单，listDeviceNos 与 listFilesByDeviceNoAndType 不在、受全局登录保护——匿名可调不等于「面向 App」，归属以调用图与语义为准。
• 「非 app」是归属结论不是封禁：端点在服务端真实存在且可调用；零售 App 若确有使用需求，应先补调用图证据再评估是否升级为零售正本，而不是按本表直接对接。
• 本表条目与 18 张账号族引用薄页同属「引用 / 归属登记」档：与 web 共用 3 项计入统计口径的「引用 21」，非 app 5 项即「兼容候选 5」。

依据：本页为归属表页，端点身份、调用图与鉴权边界以后端源码 + web 仓库调用图为据；适用基线 源码归纳 @ 2026-09-14。验证口径见验证状态与依据。