yaosutu b3f88c29fa docs(changelog): 修正补全出行信息接口错误码表(实测校准)

身份证重复 581105->581119，补 581102(订单不存在)/581104(分组超限)/581118(缺必填)/400/401。23 用例真实 HTTP 测试校准。

2026-06-06 13:59:17 +08:00

3.8 KiB

原始文件 Blame 文件历史

【管理后台+小程序】餐厅资源新增「是否收费」字段

类型: 出参新增字段（管理后台+小程序同步打通）服务: hl-resource-service + hl-mp-service 日期: 2026-06-01 影响范围: /admin/restaurant 和 /mp/restaurant 相关接口 关联工单: #3317 PR: #3318 需前端配合: ✅ 是（出参新增字段，入参 Create/Update 需传值）

一、改动概要

餐厅资源（resource-service）新增 is_charged 列，值来自字典 sys_yes_no（1=是 / 0=否）。
管理后台 4 个餐厅接口和小程序 2 个餐厅接口同步透传新字段，与景区 #3313/#3315 完全同款。

二、受影响接口

管理后台（`/admin/restaurant`）

接口	方法	变化
`POST /admin/restaurant/item`	创建餐厅	入参新增 `isCharged`（可选，默认 0）
`PUT /admin/restaurant/item/{restaurantId}`	更新餐厅	入参新增 `isCharged`（可选，不传则不更新）
`GET /admin/restaurant/item/{restaurantId}`	餐厅详情	出参新增 `isCharged` + `isChargedLabel`
`GET /admin/restaurant/items`	餐厅列表	出参新增 `isCharged` + `isChargedLabel`

小程序（`/mp/restaurant`）

接口	方法	变化
`GET /mp/restaurant/{restaurantId}`	餐厅详情	出参新增 `isCharged` + `isChargedLabel`
`GET /mp/restaurant/list`	餐厅列表	出参新增 `isCharged` + `isChargedLabel`

三、字段说明

出参新增字段（详情 + 列表均有）

字段	类型	说明
`isCharged`	Integer	是否收费：1=是，0=否；历史数据默认 0
`isChargedLabel`	String	中文显示值（取自字典 `sys_yes_no`）；字典服务不可用时降级为 `null`

入参新增字段（Create / Update）

字段	类型	必填	校验	默认值
`isCharged`	Integer	否	0 ≤ 值 ≤ 1	Create 默认 `0`；Update 不传则不更新

四、字典 `sys_yes_no`

字典已在后台配置，前端无需额外配置。

字典值	中文标签
`1`	是
`0`	否

isChargedLabel 由后端自动从字典翻译，前端直接展示即可。

五、请求 / 响应示例

5.1 创建餐厅（含 isCharged）

POST /admin/restaurant/item
Authorization: Bearer <token>
Content-Type: application/json

{
  "name": "云端藏餐",
  "categoryCode": "TIBETAN",
  "isCharged": 1
}

响应（出参含新字段）：

{
  "code": 200,
  "data": {
    "restaurantId": "1900123456789000001",
    "name": "云端藏餐",
    "isCharged": 1,
    "isChargedLabel": "是"
  }
}

5.2 餐厅列表

GET /admin/restaurant/items?page=1&pageSize=10

{
  "code": 200,
  "data": {
    "total": 2,
    "list": [
      {
        "restaurantId": "1900123456789000001",
        "name": "云端藏餐",
        "isCharged": 1,
        "isChargedLabel": "是"
      },
      {
        "restaurantId": "1900123456789000002",
        "name": "草原烤肉",
        "isCharged": 0,
        "isChargedLabel": "否"
      }
    ]
  }
}

5.3 字典降级场景（`isChargedLabel` 为 null）

字典服务短暂不可用时，isCharged 有值，isChargedLabel 返回 null；前端建议做兜底处理：

{
  "restaurantId": "1900123456789000001",
  "isCharged": 1,
  "isChargedLabel": null
}

六、历史数据

所有存量餐厅 is_charged 默认值为 0，isChargedLabel 返回 "否"。

七、关联

Issue: wx/HL#3317
PR: wx/HL#3318
同款景区改动: #3313（管理后台）/ #3315（小程序）
后端负责人: 腰苏图

3.8 KiB 原始文件 Blame 文件历史 Unescape Escape