验真平台API文档


非实时空号批量检测(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> &quot;认证信息参数和统一响应参数&quot;)</li> <li>如需加密对接请查看页面 [加密对接说明](<a href="https://www.showdoc.cc/p/dfff667dec3c68748dddde67674eb993">https://www.showdoc.cc/p/dfff667dec3c68748dddde67674eb993</a> &quot;加密对接说明&quot;),并联系运营人员进行配置</li> </ul> <h5>校验请求参数(param)</h5> <table> <thead> <tr> <th>参数名</th> <th>是否必填</th> <th>类型</th> <th>&lt;div style=&quot;width: 400px&quot;/&gt;说明</th> </tr> </thead> <tbody> <tr> <td>phones</td> <td>是</td> <td>string</td> <td>手机号,1~50个,多个使用英文逗号(“,”)分隔</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code>{ (认证信息参数) &amp;quot;param&amp;quot;: { &amp;quot;phones&amp;quot;: &amp;quot;15001090000,15001090001,15001090002&amp;quot; } }</code></pre> <h5>产品响应参数(data)</h5> <p>验真状态码及描述请查看本页章节 <code>验真状态码及描述</code> 。</p> <table> <thead> <tr> <th>参数名</th> <th>是否必填</th> <th>类型</th> <th>父元素</th> <th>&lt;div style=&quot;width: 400px&quot;/&gt;说明</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>{ (统一响应参数) &amp;quot;data&amp;quot;: { &amp;quot;state&amp;quot;:&amp;quot;1&amp;quot;, &amp;quot;desc&amp;quot;:&amp;quot;成功&amp;quot;, &amp;quot;requestCount&amp;quot;:2, &amp;quot;billingCount&amp;quot;:1, &amp;quot;result&amp;quot;:{ &amp;quot;15000000000&amp;quot;:{ &amp;quot;state&amp;quot;:&amp;quot;1&amp;quot;, &amp;quot;desc&amp;quot;:&amp;quot;空号&amp;quot; }, &amp;quot;15000000001&amp;quot;:{ &amp;quot;state&amp;quot;:&amp;quot;0&amp;quot;, &amp;quot;desc&amp;quot;:&amp;quot;失败&amp;quot; } } } }</code></pre> <h6>查询失败</h6> <pre><code>{ (统一响应参数) &amp;quot;data&amp;quot;: { &amp;quot;state&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;desc&amp;quot;: &amp;quot;失败&amp;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>

页面列表

ITEM_HTML