非实时空号批量检测(phone_check_batch)
<p>[TOC]</p>
<h5>产品描述</h5>
<ul>
<li>批量输入多个手机号,输出每个手机号的状态,包括:空号、实号、停机、沉默号、风险号。</li>
</ul>
<h5>接口地址</h5>
<ul>
<li>请求地址:<code>https://api.caih.com/verify/api/phone_check_batch</code></li>
<li>请求方式:POST</li>
<li>接口数据类型:JSON</li>
<li>编码方式:UTF-8</li>
<li>接口参数传递位置:请求体body</li>
<li>接口参数传递内容:认证信息参数(authinfo)和校验请求参数(param)</li>
</ul>
<h5>接口须知</h5>
<ul>
<li><strong>认证信息参数</strong> 和 <strong>统一响应参数</strong>请查看页面 [认证信息参数和统一响应参数](<a href="https://www.showdoc.cc/p/52021eddfd9994a7b84d891a16e27f66">https://www.showdoc.cc/p/52021eddfd9994a7b84d891a16e27f66</a> "认证信息参数和统一响应参数")</li>
<li>如需加密对接请查看页面 [加密对接说明](<a href="https://www.showdoc.cc/p/dfff667dec3c68748dddde67674eb993">https://www.showdoc.cc/p/dfff667dec3c68748dddde67674eb993</a> "加密对接说明"),并联系运营人员进行配置</li>
</ul>
<h5>校验请求参数(param)</h5>
<table>
<thead>
<tr>
<th>参数名</th>
<th>是否必填</th>
<th>类型</th>
<th><div style="width: 400px"/>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>phones</td>
<td>是</td>
<td>string</td>
<td>手机号,1~50个,多个使用英文逗号(“,”)分隔</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>{
(认证信息参数)
&quot;param&quot;: {
&quot;phones&quot;: &quot;15001090000,15001090001,15001090002&quot;
}
}</code></pre>
<h5>产品响应参数(data)</h5>
<p>验真状态码及描述请查看本页章节 <code>验真状态码及描述</code> 。</p>
<table>
<thead>
<tr>
<th>参数名</th>
<th>是否必填</th>
<th>类型</th>
<th>父元素</th>
<th><div style="width: 400px"/>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>state</td>
<td>是</td>
<td>string</td>
<td>data</td>
<td>批次验真状态码</td>
</tr>
<tr>
<td>desc</td>
<td>是</td>
<td>string</td>
<td>data</td>
<td>批次验真状态码描述</td>
</tr>
<tr>
<td>requestCount</td>
<td>否</td>
<td>int</td>
<td>data</td>
<td>请求个数,去重和检查格式后需查询的个数</td>
</tr>
<tr>
<td>billingCount</td>
<td>否</td>
<td>int</td>
<td>data</td>
<td>计费个数</td>
</tr>
<tr>
<td>result</td>
<td>否</td>
<td>json</td>
<td>data</td>
<td>每个手机号状态的父元素</td>
</tr>
<tr>
<td>实际的手机号</td>
<td>否</td>
<td>json</td>
<td>result</td>
<td>手机号,如:15000000000,数量和请求个数相同</td>
</tr>
<tr>
<td>state</td>
<td>否</td>
<td>string</td>
<td>实际的手机号</td>
<td>验真状态码</td>
</tr>
<tr>
<td>desc</td>
<td>否</td>
<td>string</td>
<td>实际的手机号</td>
<td>验真状态码描述</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<h6>查询成功</h6>
<pre><code>{
(统一响应参数)
&quot;data&quot;: {
&quot;state&quot;:&quot;1&quot;,
&quot;desc&quot;:&quot;成功&quot;,
&quot;requestCount&quot;:2,
&quot;billingCount&quot;:1,
&quot;result&quot;:{
&quot;15000000000&quot;:{
&quot;state&quot;:&quot;1&quot;,
&quot;desc&quot;:&quot;空号&quot;
},
&quot;15000000001&quot;:{
&quot;state&quot;:&quot;0&quot;,
&quot;desc&quot;:&quot;失败&quot;
}
}
}
}</code></pre>
<h6>查询失败</h6>
<pre><code>{
(统一响应参数)
&quot;data&quot;: {
&quot;state&quot;: &quot;0&quot;,
&quot;desc&quot;: &quot;失败&quot;
}
}</code></pre>
<h5>批次验真状态码及描述</h5>
<table>
<thead>
<tr>
<th>批次验真状态码(state)</th>
<th>批次验真状态码描述(desc)</th>
<th>是否收费</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>0</td>
<td>失败</td>
<td>否</td>
</tr>
<tr>
<td>1</td>
<td>成功</td>
<td>是</td>
<td>该情况有其他相应参数</td>
</tr>
</tbody>
</table>
<h5>验真状态码及描述</h5>
<table>
<thead>
<tr>
<th>验真状态码(state)</th>
<th>验真状态码描述(desc)</th>
<th>是否收费</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>0</td>
<td>失败</td>
<td>否</td>
</tr>
<tr>
<td>1</td>
<td>空号</td>
<td>是</td>
<td>近一个月内出现过的空号</td>
</tr>
<tr>
<td>2</td>
<td>实号</td>
<td>是</td>
<td>活跃号码</td>
</tr>
<tr>
<td>3</td>
<td>停机</td>
<td>是</td>
<td>近一个月内出现过的停机</td>
</tr>
<tr>
<td>4</td>
<td>沉默号</td>
<td>是</td>
<td>超过六个月未激活过的空号和近三个月平均流量低于30M的用户</td>
</tr>
<tr>
<td>5</td>
<td>风险号</td>
<td>是</td>
<td>长时间关机或未开通语音服务以及易投诉的用户</td>
</tr>
</tbody>
</table>