POST/system/notice/querySystemNoticeList管理后台开放/回调

通知公告表-列表查询

平台与系统 / 系统·公告· SystemNoticeController#querySystemNoticeList

基本信息

  • 接口状态开放/回调用(服务端) 置信度 中 免鉴权
  • 接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/system/notice/querySystemNoticeList
  • 请求方式POST
  • Content-Typeapplication/json
  • 暴露渠道管理后台、开放/回调 前缀 /manage-api
  • 名称来源源码注释
  • 调用方本次扫描未发现调用 不等于可以下线
  • 需求上下文系统公告和阿里云人脸核验
  • 维护人 / 最后改动liuxu 2026-02-03 最近提交:系统公告和阿里云人脸核验
  • 读写数据表system_notice 反查该表全部接口 →
  • 控制器com.jxxx.dscp.api.controller.system.SystemNoticeController#querySystemNoticeList
  • 源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/system/SystemNoticeController.java:73
  • 判定依据渠道为开放/回调且有实现链路,由第三方或支付回调触发

请求参数

Header 请求参数

参数名参数值是否必填参数类型描述说明
无(渠道统一鉴权头见《认证方式》)

Query 请求参数

参数名参数值是否必填参数类型描述说明
无

路径参数及说明

参数名参数值是否必填参数类型描述说明
无

Body 请求参数

Body 类型 SystemNoticeListRequest
参数名参数值是否必填参数类型描述说明
keywords…否String关键字

认证方式

免鉴权:@Route(auth = false) —— 该接口不校验登录态,改动前确认调用方与签名校验。

响应参数

data 类型 List<SystemNoticeResponse>
参数名参数值是否必填参数类型描述说明
id…否Longid → system_notice.id
title…否String → system_notice.title
content…否String公告内容 → system_notice.content
type…否Integer公告类型(1通知 2公告) → system_notice.type
status…否Integer公告状态(0正常 1关闭) → system_notice.status
creator…否String创建者 → system_notice.creator
createTime…否Date创建时间 → system_notice.create_time
updater…否String更新者 → system_notice.updater
updateTime…否Date更新时间 → system_notice.update_time
deleted…否Boolean是否删除 → system_notice.deleted
tenantId…否Long租户编号 → system_notice.tenant_id
sort…否Integer → system_notice.sort

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": "1",
    "title": "\"string\"",
    "content": "\"string\"",
    "type": "1",
    "status": "1",
    "creator": "\"string\"",
    "createTime": "\"2026-01-01 00:00:00\"",
    "updater": "\"string\"",
    "updateTime": "\"2026-01-01 00:00:00\"",
    "deleted": "false",
    "tenantId": "1",
    "sort": "1"
  }
}
示例来自源码/导出内容,仅结构参考,非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表:system_notice 反查全部引用接口 →
  • SystemNoticeController#querySystemNoticeList
  • SystemNoticeService#queryList(SystemNoticeServiceImpl)
  • SystemNoticeMapper#queryList
  • BeanUtils.map → SystemNoticeQuery
  • BeanUtils.mapList → SystemNoticeResponse
由 tools/build.py 从 data/apis.json 生成 · 生成时间 2026-09-12 19:49 · 数据口径见说明 · 本页数字非手写,均来自同一份数据