手机在网状态（phone_netstatus）
<p>[TOC]</p>
<h5>产品描述</h5>
<ul>
<li>查询手机号的在网状态，如正常、停机、销号、在网不可用等。</li>
</ul>
<h5>接口地址</h5>
<ul>
<li>请求地址：<code>https://api.caih.com/verify/api/phone_netstatus</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" title="认证信息参数和统一响应参数">认证信息参数和统一响应参数</a></li>
<li>如需加密对接请查看页面 <a href="https://www.showdoc.cc/p/dfff667dec3c68748dddde67674eb993" title="加密对接说明">加密对接说明</a>，并联系运营人员进行配置</li>
</ul>
<h5>校验请求参数（param）</h5>
<p>服务编码请查看本页章节 <code>验真状态码及描述</code> 。</p>
<table>
<thead>
<tr>
<th>参数名</th>
<th>是否必填</th>
<th>类型</th>
<th><div style="width: 400px"/>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>phone</td>
<td>是</td>
<td>string</td>
<td>手机号，11位</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>{
(认证信息参数)
"param": {
"phone": "15001090000"
}
}</code></pre>
<h5>产品响应参数（data）</h5>
<p>验真状态码及描述请查看本页章节 <code>验真状态码及描述</code> 。</p>
<table>
<thead>
<tr>
<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>验真状态码</td>
</tr>
<tr>
<td>desc</td>
<td>是</td>
<td>string</td>
<td>验真状态码描述</td>
</tr>
<tr>
<td>provider</td>
<td>否</td>
<td>string</td>
<td>返回号码当前归属的运营商，正数为非携号转网，负数为携号转网，具体如下：非携号转网：1 移动、2 电信、3 联通；携号转网：-1 移动、-2 电信、-3 联通</td>
</tr>
<tr>
<td>status</td>
<td>否</td>
<td>string</td>
<td>移动：1 正常 2 单停/停机/预销号 3 在网不可用 4 销号/未启用 电信：1 正常 2 停机 3 未启用/在网但不可用 4 销号/不在网 联通：1 正常 2 停机 3 在网但不可用 4 销号/未启用</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<h6>查询成功</h6>
<pre><code>{
(统一响应参数)
"data": {
"state": "1",
"desc": "成功",
"provider": "1",
"status": "1"
}
}</code></pre>
<h6>查询失败</h6>
<pre><code>{
(统一响应参数)
"data": {
"state": "0",
"desc": "失败"
}
}</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>