系统维护错误码（178*）

段位：178001 - 178099；V1 暴露 1 个（178004）；178001-178003 仅在管理端 / 同步等非 V1 集成路径触发，不在本参考之列
通用约定（HTTP status / code=1 兜底 / 响应结构）见 README
178004 不绑定单一端点：平台进入维护窗口期后，除少数白名单端点外，全部 V1 端点都可能统一返回此码。

178004 MAINTENANCE_MODE_ACTIVE

HTTP status：200
含义：系统处于维护态，服务暂不可用
典型触发条件：平台管理方进入系统维护窗口期间调用任意 V1 端点。以下白名单端点在维护期间仍正常可用、不返回此码：鉴权令牌签发（/v1/auth/token）、公开分享访问（/public/*）、健康检查
处理建议：msg 携带维护原因文案，可向最终用户透出「系统维护中」提示并暂停重试；维护态由人工恢复、无固定时长，响应不携带 Retry-After，建议以分钟级间隔轮询或订阅运维方的维护窗口通知，待恢复后继续调用。请勿将此码当作请求参数错误或权限错误处理——请求本身有效，待维护结束后原样重发即可
示例响应：

json

{ "code": 178004, "msg": "系统维护中：版本升级，预计 30 分钟", "data": null }