手机三要素核验(全SHA256详版)(identity3d_all_sha256)
<p>[TOC]</p>
<h5>产品描述</h5>
<ul>
<li>根据输入的身份证号(SHA256加密)、手机号(SHA256加密)、姓名(SHA256加密)、手机号前四位,核验与运营商的登记信息是否一致,不一致时会返回具体哪里不一致。</li>
</ul>
<h5>接口地址</h5>
<ul>
<li>请求地址:<code>https://api.caih.com/verify/api/identity3d_all_sha256</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>
</ul>
<h5>校验请求参数(param)</h5>
<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>手机号(SHA256加密后的串均小写)</td>
</tr>
<tr>
<td>idcode</td>
<td>是</td>
<td>string</td>
<td>身份证号(SHA256加密后的串均小写;如身份证号含X,请将X转大写后再SHA256加密)</td>
</tr>
<tr>
<td>name</td>
<td>是</td>
<td>string</td>
<td>姓名(SHA256加密后的串均小写)</td>
</tr>
<tr>
<td>phonePre</td>
<td>否</td>
<td>string</td>
<td>手机号前缀(明文),手机号前四位,不填该参数,自动填充为“1369”</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>{
(认证信息参数)
&quot;param&quot;: {
&quot;phone&quot;: &quot;e44d19a618e44d19a618ef5ca29a68b7627d2fa10cef5ca29a68b7627d2fa10c&quot;,
&quot;idcode&quot;: &quot;27e612a2a14dea978483e44d19a618ef5ca29a68b7627d2fa10c61b5a4eba8b2&quot;,
&quot;name&quot;: &quot;722e3b2dccb3f9e7af0dbd0ca3dab8c74ff707f4c6d9e67f3e7e78a0cd2a2437&quot;,
&quot;phonePre&quot;: &quot;1500&quot;
}
}</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>
</tbody>
</table>
<h5>返回示例</h5>
<h6>查询成功</h6>
<pre><code>{
(统一响应参数)
&quot;data&quot;: {
&quot;state&quot;: &quot;1&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>
</tr>
<tr>
<td>2</td>
<td>手机号已实名,身份证和姓名均与实名信息不一致</td>
<td>是</td>
</tr>
<tr>
<td>3</td>
<td>手机号已实名,手机号和身份证一致,姓名不一致</td>
<td>是</td>
</tr>
<tr>
<td>4</td>
<td>手机号已实名,手机号和姓名一致,身份证不一致</td>
<td>是</td>
</tr>
</tbody>
</table>