POST/statistics/statHomeBindTrend管理后台
首页-绑卡趋势统计(按日/月/年)
统计与报表 / 首页统计· HomeStatisticsController#statHomeBindTrend
基本信息
- 接口状态前端在用 置信度 高
- 接口URLPOST
https://dscp-dev.hn12301.net/manage-api/statistics/statHomeBindTrend - 请求方式
POST - Content-Type
application/json - 暴露渠道管理后台 前缀
/manage-api - 名称来源源码注释
- 调用方已确认在用 · 管理后台(1 个前端)
- 需求上下文feat: 首页统计仪表盘数据权限与绑卡/渠道/资源统计接口
- 维护人 / 最后改动jacobxu666 2026-09-09 最近提交:feat: 首页统计仪表盘数据权限与绑卡/渠道/资源统计接口
- 读写数据表—
- 控制器
com.jxxx.dscp.api.controller.statistics.HomeStatisticsController#statHomeBindTrend - 源码位置
jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/statistics/HomeStatisticsController.java:213 - 判定依据1 个调用点:dscp-html-manage/src/api/home/index.ts
请求参数
Header 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|
| 无(渠道统一鉴权头见《认证方式》) |
Body 请求参数
Body 类型 HomeSalesAmountStatRequest
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|
| periodType | … | 否 | PeriodType | 统计类型,1日统计2月统计3年统计 1=日 2=月 3=年 |
| datePair | … | 否 | Date[] | 日期区间 |
| merchantId | … | 否 | Long | xuchao: 首页统计数据范围-商户ID。注意:本 DTO 同时挂 OPEN_API auth=false 公开路由, NO_AUTH 模式不支持 @MvcInject,需由 controller 在服务端显式赋值(公开面保持 null=全量) */ |
| cardModelId | … | 否 | Long | xuchao: 卡种筛选(可空=全部卡种),供绑卡趋势等复用 */ |
响应参数
data 类型 List<HomeBindTrendStatResponse>
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|
| time | … | 否 | String | 时间点(按日 yyyy-MM-dd / 按月 yyyy-MM / 按年 yyyy) |
| bindNum | … | 否 | Integer | xuchao: 该时间点绑卡数(card.is_bind=1,bind_time 归期,按卡数) |
响应示例
成功响应示例 code=0
{
"errcode": 0,
"errmsg": "",
"data": {
"time": "\"string\"",
"bindNum": "1"
}
}示例来自源码/导出内容,仅结构参考,非线上真实数据。
附录 · 实现细节
调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
- HomeStatisticsController#statHomeBindTrend
- SessionUserService#getSessionUser
- StatisticsService#statHomeBindTrend(StatisticsServiceImpl)
- StatisticsMapper#statHomeBindTrend
调用点证据dscp-html-manage/src/api/home/index.ts:44 管理后台 · request