渠道区域报备迭代V2.0

渠道区域报备迭代V2.0


渠道商业务区域配置信息分页查询接口

<h3>渠道商业务区域配置信息分页查询接口文档</h3> <hr /> <h4><strong>接口名称</strong></h4> <p>渠道商业务区域配置信息分页查询</p> <h4><strong>请求方法</strong></h4> <p><code>GET</code></p> <h4><strong>请求URL</strong></h4> <p><code>/api/cbn/tenantBizArea/page</code></p> <hr /> <h3>请求参数</h3> <h4>1. 分页参数(<code>pageInfo.*</code>)</h4> <table> <thead> <tr> <th>参数名称</th> <th>类型</th> <th>必填</th> <th>说明</th> <th>示例值</th> </tr> </thead> <tbody> <tr> <td>pageInfo.pageNum</td> <td>Integer</td> <td>是</td> <td>当前页码,从1开始</td> <td>1</td> </tr> <tr> <td>pageInfo.pageSize</td> <td>Integer</td> <td>否</td> <td>每页条数,默认10</td> <td>10</td> </tr> </tbody> </table> <h4>2. 查询条件(<code>query.*</code>)</h4> <table> <thead> <tr> <th>参数名称</th> <th>类型</th> <th>必填</th> <th>说明</th> <th>示例值</th> </tr> </thead> <tbody> <tr> <td>query.tenantCodeEq</td> <td>String</td> <td>否</td> <td>渠道商编码(精确匹配)</td> <td>1042</td> </tr> <tr> <td>query.alarmProcessTypes</td> <td>String</td> <td>否</td> <td>告警处置类型(多选逗号分隔,值见 <code>model.dict.alarmProcessTypes</code>)</td> <td>10,20</td> </tr> <tr> <td>query.status</td> <td>Integer</td> <td>否</td> <td>状态(0: 停用, 1: 启用)</td> <td>1</td> </tr> </tbody> </table> <hr /> <h3>响应结构</h3> <h4>1. 基础响应字段</h4> <table> <thead> <tr> <th>字段名</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>code</td> <td>Integer</td> <td>响应码(0: 成功)</td> </tr> <tr> <td>msg</td> <td>String</td> <td>响应消息(如“操作成功”)</td> </tr> <tr> <td>rqtid</td> <td>String</td> <td>请求唯一标识</td> </tr> <tr> <td>versionCode</td> <td>String</td> <td>接口版本号</td> </tr> <tr> <td>data</td> <td>Object</td> <td>分页数据主体</td> </tr> <tr> <td>model</td> <td>Object</td> <td>字典及配置数据</td> </tr> </tbody> </table> <h4>2. 分页数据(<code>data</code>)</h4> <table> <thead> <tr> <th>字段名</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>total</td> <td>Long</td> <td>总记录数</td> </tr> <tr> <td>pageSize</td> <td>Integer</td> <td>每页条数</td> </tr> <tr> <td>rows</td> <td>Array</td> <td>当前页数据列表</td> </tr> <tr> <td>pageNum</td> <td>Integer</td> <td>当前页码</td> </tr> <tr> <td>pages</td> <td>Integer</td> <td>总页数</td> </tr> </tbody> </table> <h4>3. 数据行(<code>rows</code> 数组元素)</h4> <table> <thead> <tr> <th>字段名</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>id</td> <td>Long</td> <td>主键</td> </tr> <tr> <td>tenantCode</td> <td>String</td> <td>渠道商编码</td> </tr> <tr> <td>bizArea</td> <td>String</td> <td>业务区域ID(多个用逗号分隔,对应 <code>sys_cn_area.id</code>)</td> </tr> <tr> <td>bizProvName</td> <td>String</td> <td>业务省名称(多个用分号分隔)</td> </tr> <tr> <td>bizCityName</td> <td>String</td> <td>业务市名称(多个用分号分隔,格式 <code>省-市</code>)</td> </tr> <tr> <td>areaThreshold</td> <td>BigDecimal</td> <td>业务区域限定阈值(百分比,如 20.00)</td> </tr> <tr> <td>areaThresholdStr</td> <td>String</td> <td>阈值格式化字符串(如 &quot;20.00%&quot;)</td> </tr> <tr> <td>alarmDay</td> <td>Integer</td> <td>告警监测天数</td> </tr> <tr> <td>alarmActiveNum</td> <td>Integer</td> <td>告警检测激活数</td> </tr> <tr> <td>alarmProcessTypes</td> <td>String</td> <td>告警处置类型(多个逗号分隔,值见字典)</td> </tr> <tr> <td>alarmProcessTypeLabels</td> <td>String</td> <td>处置措施标签(多个逗号分隔,如 &quot;告警提醒处理,限制开卡处理&quot;)</td> </tr> <tr> <td>alarmSmsTypes</td> <td>String</td> <td>告警消息目标类型(多个逗号分隔,值见字典)</td> </tr> <tr> <td>alarmSmsTypeLabels</td> <td>String</td> <td>告警消息目标标签(多个逗号分隔)</td> </tr> <tr> <td>agentPerson</td> <td>String</td> <td>代理告警人(手机号)</td> </tr> <tr> <td>businessPerson</td> <td>String</td> <td>商务告警人(手机号)</td> </tr> <tr> <td>status</td> <td>Integer</td> <td>状态(0: 停用, 1: 启用)</td> </tr> <tr> <td>remark</td> <td>String</td> <td>备注</td> </tr> <tr> <td>createTime</td> <td>String</td> <td>创建时间(格式 <code>yyyy-MM-dd HH:mm:ss</code>)</td> </tr> <tr> <td>createUser</td> <td>Long</td> <td>创建用户ID</td> </tr> </tbody> </table> <h4>4. 字典数据(<code>model.dict</code>)</h4> <table> <thead> <tr> <th>字段名</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>alarmProcessTypes</td> <td>Map</td> <td>告警处置类型字典(键值对,如 <code>{&amp;quot;10&amp;quot;: &amp;quot;告警提醒处理&amp;quot;, &amp;quot;20&amp;quot;: &amp;quot;限制开卡处理&amp;quot;}</code>)</td> </tr> <tr> <td>alarmSmsTypes</td> <td>Map</td> <td>告警消息目标类型字典(键值对,如 <code>{&amp;quot;10&amp;quot;: &amp;quot;代理商负责人(短信通知)&amp;quot;, ...}</code>)</td> </tr> <tr> <td>status</td> <td>Map</td> <td>状态字典(<code>{&amp;quot;0&amp;quot;: &amp;quot;禁用&amp;quot;, &amp;quot;1&amp;quot;: &amp;quot;启用&amp;quot;}</code>)</td> </tr> <tr> <td>tenantCode</td> <td>Map</td> <td>渠道商编码映射(如 <code>{&amp;quot;1042&amp;quot;: &amp;quot;广东西江技术有限公司(15008)&amp;quot;}</code>)</td> </tr> <tr> <td>createUser</td> <td>Map</td> <td>创建用户ID与名称映射(如 <code>{&amp;quot;115&amp;quot;: &amp;quot;黄景灿&amp;quot;}</code>)</td> </tr> </tbody> </table> <hr /> <h3>示例请求</h3> <pre><code class="language-http">GET http://localhost/api/cbn/tenantBizArea/page?pageInfo.pageNum=1&amp;amp;query.tenantCodeEq=1042&amp;amp;query.alarmProcessTypes=10&amp;amp;query.status=1</code></pre> <h3>示例响应</h3> <pre><code class="language-json">{ &amp;quot;code&amp;quot;: 0, &amp;quot;msg&amp;quot;: &amp;quot;操作成功&amp;quot;, &amp;quot;rqtid&amp;quot;: &amp;quot;310026opsopu&amp;quot;, &amp;quot;versionCode&amp;quot;: &amp;quot;2.0&amp;quot;, &amp;quot;data&amp;quot;: { &amp;quot;total&amp;quot;: 2, &amp;quot;pageSize&amp;quot;: 10, &amp;quot;rows&amp;quot;: [ { &amp;quot;id&amp;quot;: 1, &amp;quot;tenantCode&amp;quot;: &amp;quot;1042&amp;quot;, &amp;quot;bizArea&amp;quot;: &amp;quot;2018&amp;quot;, &amp;quot;bizProvName&amp;quot;: &amp;quot;广东省&amp;quot;, &amp;quot;bizCityName&amp;quot;: &amp;quot;广东省-广州市;广东省-汕尾市;...&amp;quot;, &amp;quot;areaThreshold&amp;quot;: 20.00, &amp;quot;areaThresholdStr&amp;quot;: &amp;quot;20.00%&amp;quot;, &amp;quot;alarmDay&amp;quot;: 5, &amp;quot;alarmActiveNum&amp;quot;: 100, &amp;quot;alarmProcessTypes&amp;quot;: &amp;quot;10,20&amp;quot;, &amp;quot;alarmProcessTypeLabels&amp;quot;: &amp;quot;告警提醒处理,限制开卡处理&amp;quot;, &amp;quot;alarmSmsTypes&amp;quot;: &amp;quot;10,20&amp;quot;, &amp;quot;alarmSmsTypeLabels&amp;quot;: &amp;quot;代理商负责人(短信通知),商务负责人(短信通知)&amp;quot;, &amp;quot;agentPerson&amp;quot;: &amp;quot;19128983352&amp;quot;, &amp;quot;businessPerson&amp;quot;: &amp;quot;19128983352&amp;quot;, &amp;quot;status&amp;quot;: 1, &amp;quot;createTime&amp;quot;: &amp;quot;2025-04-18 11:54:06&amp;quot;, &amp;quot;createUser&amp;quot;: 1 } ], &amp;quot;pageNum&amp;quot;: 1, &amp;quot;pages&amp;quot;: 1 }, &amp;quot;model&amp;quot;: { &amp;quot;dict&amp;quot;: { &amp;quot;alarmProcessTypes&amp;quot;: { &amp;quot;10&amp;quot;: &amp;quot;告警提醒处理&amp;quot;, &amp;quot;20&amp;quot;: &amp;quot;限制开卡处理&amp;quot; }, &amp;quot;alarmSmsTypes&amp;quot;: { &amp;quot;10&amp;quot;: &amp;quot;代理商负责人(短信通知)&amp;quot;, &amp;quot;20&amp;quot;: &amp;quot;商务负责人(短信通知)&amp;quot;, &amp;quot;30&amp;quot;: &amp;quot;代理商系统界面告警提示&amp;quot; }, &amp;quot;status&amp;quot;: { &amp;quot;0&amp;quot;: &amp;quot;禁用&amp;quot;, &amp;quot;1&amp;quot;: &amp;quot;启用&amp;quot; } } } }</code></pre> <hr /> <h3>注意事项</h3> <ol> <li><strong>分页参数</strong>:若未指定 <code>pageInfo.pageSize</code>,默认每页返回10条数据。</li> <li><strong>查询条件</strong>:所有 <code>query.*</code> 参数为可选,支持组合查询。</li> <li><strong>字典映射</strong>:<code>model.dict</code> 中的键值对用于前端展示标签(如将 <code>alarmProcessTypes=10</code> 显示为“告警提醒处理”)。</li> <li><strong>时间格式</strong>:<code>createTime</code> 字段返回格式为 <code>yyyy-MM-dd HH:mm:ss</code>。</li> </ol>

页面列表

ITEM_HTML