渠道商业务区域配置信息分页查询接口
<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>阈值格式化字符串(如 "20.00%")</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>处置措施标签(多个逗号分隔,如 "告警提醒处理,限制开卡处理")</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>{&quot;10&quot;: &quot;告警提醒处理&quot;, &quot;20&quot;: &quot;限制开卡处理&quot;}</code>)</td>
</tr>
<tr>
<td>alarmSmsTypes</td>
<td>Map</td>
<td>告警消息目标类型字典(键值对,如 <code>{&quot;10&quot;: &quot;代理商负责人(短信通知)&quot;, ...}</code>)</td>
</tr>
<tr>
<td>status</td>
<td>Map</td>
<td>状态字典(<code>{&quot;0&quot;: &quot;禁用&quot;, &quot;1&quot;: &quot;启用&quot;}</code>)</td>
</tr>
<tr>
<td>tenantCode</td>
<td>Map</td>
<td>渠道商编码映射(如 <code>{&quot;1042&quot;: &quot;广东西江技术有限公司(15008)&quot;}</code>)</td>
</tr>
<tr>
<td>createUser</td>
<td>Map</td>
<td>创建用户ID与名称映射(如 <code>{&quot;115&quot;: &quot;黄景灿&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;query.tenantCodeEq=1042&amp;query.alarmProcessTypes=10&amp;query.status=1</code></pre>
<h3>示例响应</h3>
<pre><code class="language-json">{
&quot;code&quot;: 0,
&quot;msg&quot;: &quot;操作成功&quot;,
&quot;rqtid&quot;: &quot;310026opsopu&quot;,
&quot;versionCode&quot;: &quot;2.0&quot;,
&quot;data&quot;: {
&quot;total&quot;: 2,
&quot;pageSize&quot;: 10,
&quot;rows&quot;: [
{
&quot;id&quot;: 1,
&quot;tenantCode&quot;: &quot;1042&quot;,
&quot;bizArea&quot;: &quot;2018&quot;,
&quot;bizProvName&quot;: &quot;广东省&quot;,
&quot;bizCityName&quot;: &quot;广东省-广州市;广东省-汕尾市;...&quot;,
&quot;areaThreshold&quot;: 20.00,
&quot;areaThresholdStr&quot;: &quot;20.00%&quot;,
&quot;alarmDay&quot;: 5,
&quot;alarmActiveNum&quot;: 100,
&quot;alarmProcessTypes&quot;: &quot;10,20&quot;,
&quot;alarmProcessTypeLabels&quot;: &quot;告警提醒处理,限制开卡处理&quot;,
&quot;alarmSmsTypes&quot;: &quot;10,20&quot;,
&quot;alarmSmsTypeLabels&quot;: &quot;代理商负责人(短信通知),商务负责人(短信通知)&quot;,
&quot;agentPerson&quot;: &quot;19128983352&quot;,
&quot;businessPerson&quot;: &quot;19128983352&quot;,
&quot;status&quot;: 1,
&quot;createTime&quot;: &quot;2025-04-18 11:54:06&quot;,
&quot;createUser&quot;: 1
}
],
&quot;pageNum&quot;: 1,
&quot;pages&quot;: 1
},
&quot;model&quot;: {
&quot;dict&quot;: {
&quot;alarmProcessTypes&quot;: {
&quot;10&quot;: &quot;告警提醒处理&quot;,
&quot;20&quot;: &quot;限制开卡处理&quot;
},
&quot;alarmSmsTypes&quot;: {
&quot;10&quot;: &quot;代理商负责人(短信通知)&quot;,
&quot;20&quot;: &quot;商务负责人(短信通知)&quot;,
&quot;30&quot;: &quot;代理商系统界面告警提示&quot;
},
&quot;status&quot;: {
&quot;0&quot;: &quot;禁用&quot;,
&quot;1&quot;: &quot;启用&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>