hl-api-changelog/changelogs/2026-03/24_1438_resource_status.md

1.6 KiB

API 变更通知

更新时间: 2026-03-24 14:38

⚠️ 变更 - 资源管理状态简化

涉及模块全部9个资源模块

景区、游玩项目、酒店(含房型)、车辆、额外服务、人员、餐厅、额外费用、备品

变更内容

状态值从三态改为二态:

原状态 新状态
0=草稿 0=下架
1=上架 1=上架(不变)
2=下架 已移除

简单说:去掉草稿概念,只剩上架/下架两个状态。

前端需要调整

  1. 状态筛选下拉框:去掉「草稿」选项,改为「下架(0)」和「上架(1)」
  2. 列表/详情状态标签status=0 显示「下架」(原来显示「草稿」),status=1 显示「上架」
  3. 不再需要 status=2:如果之前有 status=2 的处理逻辑,可以删除
  4. 上下架操作按钮:目标状态只传 0(下架)或 1(上架),不再传 2
  5. 审批接口 targetStatus:同上,只有 01

受影响的接口(所有资源模块通用)

  • GET /admin/{module}/list — status 参数:0=下架, 1=上架
  • PUT /admin/{module}/{id}/status — status 字段:0=下架, 1=上架
  • PUT /admin/{module}/batch/status — status 字段同上
  • POST /admin/{module}/{id}/submit-approval — targetStatus0=下架, 1=上架
  • 创建/更新接口的 status 字段同上

说明

代码实际一直只用 0 和 1 两个值STATUS_OFF=0, STATUS_ON=1,status=2 从未真正使用过。本次只是统一了 API 文档描述,使其与实际逻辑一致。数据库无变更,不影响已有数据。