人像三要素比对（face_id_match）
<p>[TOC]</p>
<h5>产品描述</h5>
<ul>
<li>输入人脸照片、身份证号、姓名，返回身份证号和姓名是否一致、和公安库人脸照的相似度。</li>
</ul>
<h5>接口地址</h5>
<ul>
<li>请求地址：<code>https://api.caih.com/verify/api/face_id_match</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>base64</td>
<td>是</td>
<td>string</td>
<td>图片的base64编码字符串，无图片头</td>
</tr>
<tr>
<td>idcode</td>
<td>是</td>
<td>string</td>
<td>身份证号</td>
</tr>
<tr>
<td>name</td>
<td>是</td>
<td>string</td>
<td>姓名</td>
</tr>
</tbody>
</table>
<p>图片要求：
图片格式：jpg或png；像素：宽和高大于15px, 小于4000px；图片大小：5KB~500KB，最大为1MB；保证五官清晰可见，尽量传正脸照片，不要旋转，不能有刘海，背光不能太强。</p>
<h5>请求示例</h5>
<pre><code>{
(认证信息参数)
&quot;param&quot;: {
&quot;base64&quot;: &quot;/9j/4AAQSkZJRgABAQIAdgB2AAD/2wBDAAgGBgcGBQgHB&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: 300px"/>说明</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>score</td>
<td>否</td>
<td>string</td>
<td>分数，[0, 100]，整数</br>[60, 100]：是同一人</br>[40, 60)：疑似同一人</br>[0, 40)：不是同一人</td>
</tr>
</tbody>
</table>
<p>客户可以根据自己需求，自定义阈值用于确定是否为同一人。</p>
<h5>返回示例</h5>
<h6>查询成功</h6>
<p>有其他响应参数：</p>
<pre><code>{
(统一响应参数)
&quot;data&quot;: {
&quot;state&quot;: &quot;1&quot;,
&quot;desc&quot;: &quot;身份证号与姓名一致，且为同一人&quot;,
&quot;score&quot;: &quot;83&quot;
}
}</code></pre>
<p>无其他响应参数：</p>
<pre><code>{
(统一响应参数)
&quot;data&quot;: {
&quot;state&quot;: &quot;4&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>
<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>
</tr>
<tr>
<td>5</td>
<td>身份证号与姓名不一致</td>
<td>是</td>
</tr>
<tr>
<td>6</td>
<td>库中无此身份证号</td>
<td>是</td>
</tr>
<tr>
<td>7</td>
<td>库中无照片</td>
<td>是</td>
</tr>
<tr>
<td>8</td>
<td>图片不合格</td>
<td>否</td>
</tr>
</tbody>
</table>