渠道区域报备迭代V2.0

渠道区域报备迭代V2.0


删除号卡指定区域接口

<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>&amp;quot;1042&amp;quot;</code></td> </tr> <tr> <td><code>changeAreaType</code></td> <td>Integer</td> <td>是</td> <td>指定号卡区域类型:&lt;br&gt;<code>10</code>=按号段,<code>20</code>=按卡号列表,<code>30</code>=按数量</td> <td><code>20</code></td> </tr> <tr> <td><code>changeMsisdnList</code></td> <td>List&lt;Object&gt;</td> <td>条件</td> <td>ICCID号列表(<code>changeAreaType=20</code>时必填)</td> <td><code>[{&amp;quot;iccid&amp;quot;:&amp;quot;89861500192441123001&amp;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">{ &amp;quot;changeAreaType&amp;quot;: &amp;quot;20&amp;quot;, &amp;quot;changeMsisdnList&amp;quot;: [ { &amp;quot;iccid&amp;quot;: &amp;quot;89861500192441123001&amp;quot; }, { &amp;quot;iccid&amp;quot;: &amp;quot;89861500192441123002&amp;quot; }, { &amp;quot;iccid&amp;quot;: &amp;quot;89861500192441123003&amp;quot; } ], &amp;quot;tenantCode&amp;quot;: &amp;quot;1042&amp;quot;, &amp;quot;tenantBizAreaId&amp;quot;: 1 }</code></pre> <h4><strong>响应示例(成功)</strong></h4> <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;310026qrtmvn&amp;quot;,     &amp;quot;versionCode&amp;quot;: &amp;quot;2.0&amp;quot;,     &amp;quot;model&amp;quot;: {         &amp;quot;dict&amp;quot;: {}     } }</code></pre> <h4><strong>响应示例(失败)</strong></h4> <pre><code class="language-json">{ &amp;quot;code&amp;quot;: 500, &amp;quot;msg&amp;quot;: &amp;quot;号卡指定区域所属配置不能为空&amp;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>错误(&quot;号卡指定区域不能为空&quot;)。</li> <li>若<code>tenantBizAreaId</code>未关联有效配置,返回<code>500</code>错误(&quot;号卡指定区域所属配置不能为空&quot;)。</li> </ul></li> </ol>

页面列表

ITEM_HTML