渠道区域报备迭代V2.0

渠道区域报备迭代V2.0


导入号卡接口

<h3>API接口文档:导入号卡信息</h3> <h4><strong>请求方式</strong></h4> <p><code>POST</code></p> <h4><strong>请求URL</strong></h4> <pre><code>/cbn/tenantBizAreaSimLog/sim/change/import</code></pre> <hr /> <h4><strong>请求参数(Body 类型 : multipart/form-data)</strong></h4> <p><code>10 按号段指定号卡业务区域</code></p> <table> <thead> <tr> <th>字段</th> <th>类型</th> <th>必填</th> <th>描述</th> <th>示例值</th> </tr> </thead> <tbody> <tr> <td><code>file</code></td> <td>file</td> <td>是</td> <td>文件</td> <td><code>1042渠道商指定区域号卡数据.xlsx</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>导入成功响应的KEY</td> </tr> </tbody> </table> <h5>变更状态枚举(<code>changeStatus</code>)</h5> <table> <thead> <tr> <th>值</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td>10</td> <td>成功</td> </tr> <tr> <td>20</td> <td>失败</td> </tr> <tr> <td>30</td> <td>号卡归属渠道商不一致</td> </tr> <tr> <td>40</td> <td>号卡已激活</td> </tr> <tr> <td>50</td> <td>号卡已指定业务区域</td> </tr> </tbody> </table> <hr /> <h4><strong>请求示例</strong></h4> <p><code>10 按号段指定号卡业务区域</code></p> <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;310026uvmqto&amp;quot;,     &amp;quot;versionCode&amp;quot;: &amp;quot;2.0&amp;quot;,     &amp;quot;data&amp;quot;: &amp;quot;1914f39b18a542fc9b01415ca70f42c2&amp;quot;,     &amp;quot;model&amp;quot;: {         &amp;quot;dict&amp;quot;: {}     } }</code></pre> <p><code>20 按ICCID集合指定号卡业务区域</code></p> <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> <p><code>30 按号卡数量指定号卡业务区域</code></p> <pre><code class="language-json">{ &amp;quot;changeAreaType&amp;quot;: 10, &amp;quot;changeCount&amp;quot;:50, &amp;quot;tenantBizAreaId&amp;quot;: 1, &amp;quot;tenantCode&amp;quot;: &amp;quot;1042&amp;quot; }</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;data&amp;quot;: { &amp;quot;success&amp;quot;: false, &amp;quot;data&amp;quot;: [ { &amp;quot;tenantCode&amp;quot;: &amp;quot;1051&amp;quot;, &amp;quot;msisdn&amp;quot;: &amp;quot;19277552720&amp;quot;, &amp;quot;iccid&amp;quot;: &amp;quot;89861500192441123001&amp;quot;, &amp;quot;changeStatus&amp;quot;: 30, &amp;quot;failMsg&amp;quot;: &amp;quot;号卡归属渠道商与当前渠道商不一致&amp;quot; }, { &amp;quot;tenantCode&amp;quot;: &amp;quot;1042&amp;quot;, &amp;quot;msisdn&amp;quot;: &amp;quot;19277552721&amp;quot;, &amp;quot;iccid&amp;quot;: &amp;quot;89861500192441123002&amp;quot;, &amp;quot;changeStatus&amp;quot;: 50, &amp;quot;failMsg&amp;quot;: &amp;quot;号卡已指定业务区域,并且非当前指定渠道商业务区域报备&amp;quot; } ], &amp;quot;changeCount&amp;quot;: 600, &amp;quot;successCount&amp;quot;: 227, &amp;quot;exceptionCount&amp;quot;: 373, &amp;quot;message&amp;quot;: &amp;quot;目前号段包含有373张卡已指定区域,是否将它改为目前指定区域?&amp;quot;, &amp;quot;requestId&amp;quot;: &amp;quot;dee1e253fb5b416e901834b6d5486b8b&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