个人不良风险核验（personal_risk）
<p>[TOC]</p>
<h5>产品描述</h5>
<ul>
<li>输入身份证号和姓名，对个人是否有不良风险进行核验，返回正常或有风险，以及风险情况。</li>
</ul>
<h5>接口地址</h5>
<ul>
<li>请求地址：<code>https://api.caih.com/verify/api/personal_risk</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>encryption</td>
<td>否</td>
<td>string</td>
<td>加密方式（0：身份证号为明文，1：身份证号做MD5加密，默认为0）</td>
</tr>
<tr>
<td>idcode</td>
<td>是</td>
<td>string</td>
<td>身份证号（明文/MD5加密后的32位小写字符串）</td>
</tr>
<tr>
<td>name</td>
<td>是</td>
<td>string</td>
<td>姓名</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>{
(认证信息参数)
&quot;param&quot;: {
&quot;encryption&quot;: &quot;0&quot;,
&quot;idcode&quot;: &quot;412825199412252999&quot;,
&quot;name&quot;: &quot;小明&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>
<tr>
<td>risk</td>
<td>否</td>
<td>string</td>
<td>个人不良风险情况</br>包括：</br>QK（前科）</br>ZT（在逃）</br>SA（涉案）</br>SD（涉毒）</br>XD（吸毒）</br>ZD（重点）</br>如果涉及多个值，中间用"&#124;"分隔，例如：QK&#124;ZT&#124;SD</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<h6>查询成功</h6>
<p>有其他响应参数：</p>
<pre><code>{
(统一响应参数)
&quot;data&quot;: {
&quot;state&quot;: &quot;2&quot;,
&quot;desc&quot;: &quot;有风险&quot;,
&quot;risk&quot;: &quot;XD|SA&quot;
}
}</code></pre>
<p>无其他相应参数：</p>
<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>
<td>该情况有其他响应参数</td>
</tr>
</tbody>
</table>