删除号卡指定区域接口
<h3>API接口文档:删除号卡指定区域</h3>
<hr />
<h4><strong>接口名称</strong></h4>
<p>清除渠道商业务区域报备号卡指定区域</p>
<h4><strong>接口描述</strong></h4>
<p>对指定的号卡业务区域进行清除处理。支持按卡号列表清除号卡区域。</p>
<hr />
<h4><strong>请求方式</strong></h4>
<p><code>POST</code></p>
<h4><strong>请求URL</strong></h4>
<pre><code>/cbn/tenantBizAreaSimLog/sim/del</code></pre>
<hr />
<h4><strong>请求参数(Body JSON)</strong></h4>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>必填</th>
<th>描述</th>
<th>示例值</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>tenantBizAreaId</code></td>
<td>Long</td>
<td>是</td>
<td>业务区域报备ID(关联主表)</td>
<td><code>1</code></td>
</tr>
<tr>
<td><code>tenantCode</code></td>
<td>String</td>
<td>是</td>
<td>号卡所属渠道商编码</td>
<td><code>&quot;1042&quot;</code></td>
</tr>
<tr>
<td><code>changeAreaType</code></td>
<td>Integer</td>
<td>是</td>
<td>指定号卡区域类型:<br><code>10</code>=按号段,<code>20</code>=按卡号列表,<code>30</code>=按数量</td>
<td><code>20</code></td>
</tr>
<tr>
<td><code>changeMsisdnList</code></td>
<td>List<Object></td>
<td>条件</td>
<td>ICCID号列表(<code>changeAreaType=20</code>时必填)</td>
<td><code>[{&quot;iccid&quot;:&quot;89861500192441123001&quot;}]</code></td>
</tr>
</tbody>
</table>
<hr />
<h4><strong>响应参数</strong></h4>
<h5>整体结构</h5>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>code</code></td>
<td>Integer</td>
<td>状态码(0=成功)</td>
</tr>
<tr>
<td><code>msg</code></td>
<td>String</td>
<td>状态描述</td>
</tr>
<tr>
<td><code>data</code></td>
<td>Object</td>
<td>校验结果数据</td>
</tr>
</tbody>
</table>
<h4><strong>请求示例</strong></h4>
<pre><code class="language-json">{
&quot;changeAreaType&quot;: &quot;20&quot;,
&quot;changeMsisdnList&quot;: [
{
&quot;iccid&quot;: &quot;89861500192441123001&quot;
},
{
&quot;iccid&quot;: &quot;89861500192441123002&quot;
},
{
&quot;iccid&quot;: &quot;89861500192441123003&quot;
}
],
&quot;tenantCode&quot;: &quot;1042&quot;,
&quot;tenantBizAreaId&quot;: 1
}</code></pre>
<h4><strong>响应示例(成功)</strong></h4>
<pre><code class="language-json">{
&quot;code&quot;: 0,
&quot;msg&quot;: &quot;操作成功&quot;,
&quot;rqtid&quot;: &quot;310026qrtmvn&quot;,
&quot;versionCode&quot;: &quot;2.0&quot;,
&quot;model&quot;: {
&quot;dict&quot;: {}
}
}</code></pre>
<h4><strong>响应示例(失败)</strong></h4>
<pre><code class="language-json">{
&quot;code&quot;: 500,
&quot;msg&quot;: &quot;号卡指定区域所属配置不能为空&quot;
}</code></pre>
<hr />
<h4><strong>注意事项</strong></h4>
<ol>
<li><strong>参数依赖规则</strong>:
<ul>
<li><code>changeAreaType=10</code>(按号段)时,<code>iccidHead</code>、<code>iccidBegin</code>、<code>iccidEnd</code>必填。</li>
<li><code>changeAreaType=20</code>(按卡号)时,<code>iccidList</code>必填。</li>
<li><code>changeAreaType=30</code>(按数量)时,<code>changeCount</code>必填。</li>
</ul></li>
<li><strong>业务校验规则</strong>:
<ul>
<li>若号卡已激活(<code>changeStatus=40</code>)或归属渠道商不一致(<code>changeStatus=30</code>),则无法变更。</li>
<li>若号卡已指定业务区域(<code>changeStatus=50</code>),需根据<code>message</code>提示用户确认是否覆盖。</li>
</ul></li>
<li><strong>错误处理</strong>:
<ul>
<li>若<code>bizAreaCode</code>或<code>bizAreaName</code>为空,返回<code>500</code>错误("号卡指定区域不能为空")。</li>
<li>若<code>tenantBizAreaId</code>未关联有效配置,返回<code>500</code>错误("号卡指定区域所属配置不能为空")。</li>
</ul></li>
</ol>