动态活体检测（life_check）
<p>[TOC]</p>
<h5>产品描述</h5>
<ul>
<li>通过传入指定动作的含有人脸的视频，检测是否为活体</li>
</ul>
<h5>接口地址</h5>
<ul>
<li>请求地址：<code>https://api.caih.com/verify/api/life_check</code></li>
<li>请求方式：POST</li>
<li>接口数据类型：multipart/form-data</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>
<table>
<thead>
<tr>
<th>参数名</th>
<th>是否必填</th>
<th>类型</th>
<th><div style="width: 400px"/>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>videoType</td>
<td>是</td>
<td>string</td>
<td>视频类型的枚举值：</br>URL：视频文件的网络地址</br>FILE：视频文件</br>默认值：URL</td>
</tr>
<tr>
<td>url</td>
<td>否</td>
<td>string</td>
<td>视频文件的网络地址，支持http/https，videoType为URL时为必填</td>
</tr>
<tr>
<td>file</td>
<td>否</td>
<td>file</td>
<td>视频的二进制文件，videoType为FILE时为必填</td>
</tr>
<tr>
<td>motion</td>
<td>是</td>
<td>string</td>
<td>检测动作的枚举值：</br>BLINK：眨眼</br>MOUTH：张嘴</br>NOD：点头</br>YAW：摇头</br>只能提交一个动作</td>
</tr>
</tbody>
</table>
<p>大小不能超过5M，常用视频格式（mp4/avi/mov/flv/f4v等）都支持。
待检测的视频需保证整个头部在视频中，五官清晰，动作幅度无需过大，否则会导致检测未通过。若整个视频有多个动作，只检测一个动作同样可成功。</p>
<h5>请求示例</h5>
<pre><code>appid=607785267fb42ad9b5bb701ada446512&
sign=eb514ea44c6586664d04240ea51be20b&
userkey=36e2a500839a49653de14fc3d7a24812&
timestamp=20190523151159&
videoType=URL&
url=http://file.service.com?id=432l4j424234jkhkhk23&
motion=BLINK</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]，整数</td>
</tr>
<tr>
<td>featureImage</td>
<td>否</td>
<td>string</td>
<td>行为特征图片的base64字符串，带图片头，检测通过时才有该字段</td>
</tr>
</tbody>
</table>
<p>默认为摇头的分数是[10, 100]为检测通过，其他动作的分数是[20, 100]为检测通过
若使用 <a href="http://tool.chinaz.com/tools/imgtobase/">http://tool.chinaz.com/tools/imgtobase/</a> 等网页工具将行为特征图片的base64字符串转为图片，需要将“\n”转为“\\n”，直接在程序中还原则不用</p>
<h5>返回示例</h5>
<h6>查询成功</h6>
<p>检测通过：</p>
<pre><code>{
(统一响应参数)
"data": {
"state": "1",
"desc": "检测通过",
"score": "35",
"featureImage": "data:image/jpg;base64,AQ/fi04143/ffsdfj\nfFJLfoe34..."
}
}</code></pre>
<p>检测未通过</p>
<pre><code>{
(统一响应参数)
"data": {
"state": "2",
"desc": "检测未通过",
"score": "12"
}
}</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>
<tr>
<td>2</td>
<td>检测未通过</td>
<td>是</td>
<td>该情况有其他响应参数</td>
</tr>
</tbody>
</table>