[后端] 短信资源管理-数据库与接口开发 115
任务名称
任务描述

功能说明

为运营平台提供短信资源池管理:平台资源调整、分配计算、预警、小区分配/历史/使用明细查询。需先核对现有代码规范与错误码表。

关联任务

  • 关联前端任务:[前端] 短信资源管理页面开发
  • 关联测试任务:[测试-后端] 短信资源管理后端测试

接口定义

请求方式GET
请求路径/api/sms/platforms

请求参数(前端对接用)

参数名类型必填说明前端来源
keywordstring平台名称搜索平台下拉搜索

响应字段(前端展示用)

字段名类型说明前端用途
idnumber平台ID后续接口参数
namestring平台名称下拉展示

业务逻辑

  1. 参数校验(正数、必填、分页)
  2. 权限检查(平台资源查看/操作)
  3. 数据处理:计算剩余可分配=剩余-已分配未使用;统计小区低于1000数量;四舍五入换算;调整/分配写历史。
  4. 返回结果:统一错误码、分页结构。

错误处理(使用系统错误码)

错误码场景前端提示
E_PARAM参数缺失/非正数参数错误
E_PERM无操作权限无权限
E_NOT_FOUND平台/小区不存在数据不存在
E_CONFLICT平台剩余不足剩余不足
相关研发需求
附件
基本信息
所属执行
所属模块
父任务
任务模式
指派给
任务类型
任务状态
优先级
进度
关键词
抄送给
工时信息
预计开始
截止日期
最初预计
h
总计消耗
0.00h
预计剩余
h
任务的一生
实际开始
由谁完成
实际完成
由谁取消
取消时间
由谁关闭
关闭原因
关闭时间