证件照检测
<h3>接口描述</h3>
<ul>
<li>根据客户发送的证件照图片，检测并返回证件照各项指标，告知调用者照片是否符合证件照要求。</li>
<li>小于6m，宽高在2500以内。</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/id-phote/check</code></p>
<h3>请求方式</h3>
<ul>
<li>POST</li>
</ul>
<h3>请求格式</h3>
<ul>
<li>form-data</li>
</ul>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>appId</td>
<td>String</td>
<td>是</td>
<td>服务商分配的唯一标识</td>
</tr>
<tr>
<td>timestamp</td>
<td>Long</td>
<td>是</td>
<td>当前时间的毫秒数</td>
</tr>
<tr>
<td>sign</td>
<td>String</td>
<td>是</td>
<td>签名，见签名算法说明</td>
</tr>
<tr>
<td>base64</td>
<td>String</td>
<td>否</td>
<td>照片base64串</td>
</tr>
<tr>
<td>file</td>
<td>File</td>
<td>否</td>
<td>照片文件</td>
</tr>
<tr>
<td>url</td>
<td>String</td>
<td>否</td>
<td>照片url</td>
</tr>
</tbody>
</table>
<p>> base64、file、url 必须提供一个，优先级：base64 > file > url
> 图片宽和⾼不能大于2500px</p>
<h3>签名算法说明</h3>
<pre><code>sign = sha256( appId + appSecret + timestamp)</code></pre>
<p>用服务商分配的 appId、服务商分配的 appSecret，当前时间毫秒数 timestamp，按上述顺序拼接成字符串，再进行 sha256 哈希得到。如下：</p>
<pre><code class="language-java">String appId = &quot;xyzxy2121zxyz&quot;；
String timestamp = &quot;1555378976238&quot;；
String appSecret = &quot;efcefcef1121cefcefc1212121&quot;；
String str = appId + appSecret + timestamp；
String sign = sha256(str)；</code></pre>
<h3>正确返回样例</h3>
<pre><code class="language-json">{
&quot;code&quot;: 200,// 返回码，详见返回码说明
&quot;msg&quot;: &quot;成功&quot;,// 返回码对应描述
&quot;taskNo&quot;: &quot;090009626222013261395536&quot;,// 本次请求号
&quot;charge&quot;: true,// 计费标志
&quot;data&quot;: {
&quot;pass&quot;: false,//检测结果
&quot;reasons&quot;: [ //在pass为false的时候，返回不合格项的提示消息
&quot;两侧肩膀姿态不佳&quot;
],
&quot;detect_result&quot;: { //图片检测的各项具体指标
&quot;color_channels&quot;: 3,//颜色通道数，一般jpeg图都是RBG三颜色通道，该值为3；对于RGBA（比如某些png）图，该值为4
&quot;nose_occlusion&quot;: 100,
&quot;face_unbalance&quot;: 83,//&gt;= 50 光照不均匀
&quot;face_num&quot;: 1,//人脸数量，整型，无人脸时，接口会直接返回错误
&quot;face_x_occupy&quot;: 0.637,//&gt;= 0.51 脸部太小 &lt;= 0.64 脸部太大
&quot;face_occlusion&quot;: 100,//脸部未被遮挡程度，取值范围[0-100]，值越小，遮挡程度越大 &gt;= 80 脸部被遮挡
&quot;shoulder_equal&quot;: 46,//两侧肩膀姿态分值，取值范围[0-100]，值越小，两侧肩膀姿态越差（不对称） &gt;= 50 两侧肩膀姿态不佳
&quot;photo_format&quot;: &quot;jpg&quot;,//图片格式：jpg, png等
&quot;mouth_occlusion&quot;: 100,
&quot;eyes_close&quot;: 100,//闭眼程度，取值范围[0-100]，值越小，闭眼程度越大（张眼程度越小）请注意：此处和mouth_close值含义相反&gt;= 80 闭眼
&quot;eyes_occlusion&quot;: 100,
&quot;eyes_y_center&quot;: 0.502,//眼睛中心点Y轴值，取值范围[0-1.0] &gt;= 0.33 脸部太靠上&lt;= 0.62 脸部太靠下
&quot;is_transparent_background&quot;: false,
&quot;glasses&quot;: &quot;no_glasses&quot;,//眼镜检测结果，可能返回三个值：no_glasses:未佩戴眼镜；normal_glasses:佩戴普通眼镜；dark_glasses: 佩戴墨镜,
&quot;mouth_close&quot;: 94,//闭嘴程度，取值范围[0-100]，值越小，张嘴程度越大（闭嘴程度越小）请注意：此处和eyes_close值含义相反 &gt;= 60 嘴巴张开过大
&quot;head_chin_y&quot;: 0.88,//头部下巴Y轴值，取值范围[0-1.0]
&quot;head_right&quot;: 0.807,//头部右侧X轴值（含头发），取值范围[0-1.0]
&quot;face_x_center&quot;: 0.513,//脸部中心点X轴值,取值范围[0-1.0] &gt;= 0.47 脸部太靠左&lt;= 0.525 脸部太靠右
&quot;dpi&quot;: [//照片dpi（可选），只有在照片中dpi值被设置的情况下，才会返回该值，否则值不存在,
300,
300
],
&quot;background_clean&quot;: 100,//背景杂乱分值，取值范围[0-100]，值越小，背景越杂乱 &gt;= 60 背景杂乱
&quot;size_mm&quot;: [ //照片毫米尺寸大小（可选），[width, height]，单位：毫米，只有在照片中dpi值被设置的情况下，才会返回该值，否则值不存在,
51,
68
],
&quot;eyes_spacing&quot;: 150,//两眼距离（两眼距离和图片总体宽度的比例），取值范围[0-1.0]
&quot;nose_tip&quot;: [
0.492,
0.609
],
&quot;size_pix&quot;: [ //照片像素尺寸大小，[width, height]，单位：像素,
600,
800
],
&quot;head_pose&quot;: { //头部在空间中的三个角度，均为浮点值
&quot;yaw_angle&quot;: -1.8058,//左右摇头角度
&quot;roll_angle&quot;: 0.5149,//歪头角度（照片平面内角度）
&quot;pitch_angle&quot;: 7.0599 //抬头或低头角度
},
&quot;face_blur&quot;: 100,//脸部清晰度，取值范围[0-100]，值越小，越模糊
&quot;file_size&quot;: 210867,//图片文件大小，单位：字节
&quot;mouthmask&quot;: 0,
&quot;head_left&quot;: 0.192,//头部左侧X轴值（含头发），取值范围[0-1.0]
&quot;background_color&quot;: [//背景色,长度为3的数组,分别表示RGB三色值:[r, g, b]
60,
144,
232
],
&quot;head_top&quot;: 0.159,//头顶Y轴值（头部上方和图片顶部的距离和图片总体高度的比例），取值范围[0-1.0]
&quot;eyes_sight&quot;: 100,
&quot;has_hat&quot;: 0,
&quot;bf_similarity&quot;: 100,//衣服和背景颜色不相似的分值，取值范围[0-100]，值越小，相似度越大
&quot;background_gradual&quot;: 0,//背景渐变分值，取值范围[0-100]，值越小，背景为渐变色的可能性越小
&quot;face_darkillum&quot;: 80 //&gt;= 60 照片过暗
}
}
}</code></pre>
<h3>错误返回样例</h3>
<pre><code class="language-json">{
&quot;msg&quot;: &quot;图片不能为空&quot;,
&quot;code&quot;: 400
}</code></pre>
<h3>返回字段说明</h3>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>返回码，详见code返回码说明</td>
</tr>
<tr>
<td>msg</td>
<td>code对应的描述</td>
</tr>
<tr>
<td>charge</td>
<td>是否计费</td>
</tr>
<tr>
<td>taskNo</td>
<td>本次请求号</td>
</tr>
<tr>
<td>data</td>
<td>返回具体结果，object类型，详见成功返回体</td>
</tr>
</tbody>
</table>
<h4>code返回码说明</h4>
<table>
<thead>
<tr>
<th>code</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>200</td>
<td>成功 （计费）</td>
</tr>
<tr>
<td>201</td>
<td>照片处理失败,错误见具体描述</td>
</tr>
<tr>
<td>202</td>
<td>人脸检测失败,错误见具体描述</td>
</tr>
<tr>
<td>203</td>
<td>照片找不到,错误见具体描述</td>
</tr>
<tr>
<td>204</td>
<td>图片尺寸过大，最大边长为2500像素</td>
</tr>
<tr>
<td>205</td>
<td>图片中找不到人脸</td>
</tr>
<tr>
<td>206</td>
<td>图片中找不到人的头部信息</td>
</tr>
<tr>
<td>207</td>
<td>证件照规格不存在</td>
</tr>
<tr>
<td>208</td>
<td>内容涉嫌违规</td>
</tr>
<tr>
<td>209</td>
<td>图片编码失败</td>
</tr>
<tr>
<td>210</td>
<td>图片不适合制作证件照</td>
</tr>
<tr>
<td>400</td>
<td>参数错误,具体查看返回的错误描述</td>
</tr>
<tr>
<td>404</td>
<td>接口地址不正确</td>
</tr>
<tr>
<td>500</td>
<td>系统维护，请稍候再试</td>
</tr>
<tr>
<td>601</td>
<td>接口未开通</td>
</tr>
<tr>
<td>602</td>
<td>账号停用</td>
</tr>
<tr>
<td>603</td>
<td>余额不足请充值</td>
</tr>
<tr>
<td>604</td>
<td>接口停用</td>
</tr>
<tr>
<td>606</td>
<td>调用超限，请稍候再试</td>
</tr>
<tr>
<td>607</td>
<td>ip不在白名单</td>
</tr>
<tr>
<td>609</td>
<td>请求过于频繁，请稍候再试</td>
</tr>
<tr>
<td>610</td>
<td>请求超时</td>
</tr>
<tr>
<td>999</td>
<td>其他，以实际返回为准</td>
</tr>
</tbody>
</table>