活体特征照片,我们致力于为用户提供专业的免费API数据接口服务
根据活体检测返回的特征照片id来获取对应的人脸照片
https://api.shuliancloud.com/v2/life/check/image/url
https://api.shuliancloud.com/v2/life/check/image/url
点击右侧按钮复制完整请求地址,参数值请替换为实际有效值
| 参数名 | 是否必填 | 参数类型 | 参数说明 |
|---|---|---|---|
| 暂无请求参数信息 | |||
# 接口名称:活体特征照片
#### 描述:传入活体检测返回的特征照片id查询人脸照片
请求地址 url:https://api.shuliancloud.com/v2/life/check/image/url
请求方式 method:get
| 名称 | 类型 |是否必填 | 说明 |
| ------------ | ------------ | ------------ | ------------ |
| appid | varchar | 是 | 服务商分配的唯一标识 |
| timestamp | number | 是 | 当前时间的毫秒数 |
| sign | varchar | 是 | 签名,<a href='#sign'>签名算法说明</a> |
| imageId | varchar | 是 | 活体返回的特征照片id, feature_image_id|
<a name="sign">
#### 签名算法说明:
###### 服务商分配的appid、unix毫秒数timestamp、商户分配的app_security、 三者通过&符号拼接成字符串进行md5加密得到。
如:appid=xyzxyzxyz,timestamp=1555378976238,app_security=efcefcefcefcefc ;
拼接后的字符串:str=xyzxyzxyz&1555378976238&efcefcefcefcefc ;
加密后得到sign = md5(str) = 4e7e1974b79f3656aeaf03f1158f5d5d ;
</a>
#### 正确返回
```
{
"code": 200,
"data": {
"featureImgUrl": "https://img.tianyandata.cn/feature_img/202107/20210730/162734622.jpg",//人脸照片url,可以直接用于人脸身份证比对接口中
"orderNo": "730566550751187120"
},
"msg": "成功",
"success": true
}
```
#### 错误返回
```
{
"msg": "参数错误",
"success": false,
"code": 400,
"data": {}
}
```
#### code错误码说明
| code | 说明 |
| ------------ | ------------ |
| 200 | 成功 |
| 400 | 参数错误 |
| 404 | 请求资源不存在 |
| 500 | 系统内部错误,请联系服务商 |
| 501 |第三方服务异常
| 601 | 服务商未开通接口权限 |
| 602 | 账号停用 |
| 603 | 次数不足,请购买套餐 |
| 604 | 接口停用 |
|606|调用超限,请联系服务商|
|1001|其他,以实际返回为准
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| 暂无返回参数信息 | ||
{
"code": 200,
"data": {
"featureImgUrl": "https://img.tianyandata.cn/feature_img/202107/20210730/162734622.jpg",//人脸照片url,可以直接用于人脸身份证比对接口中
"orderNo": "730566550751187120"
},
"msg": "成功",
"success": true
}