稳定、快速的API服务

活体特征照片,我们致力于为用户提供专业的免费API数据接口服务

活体特征照片 v1.0

最后更新: 2026-09-02 12:12:08

根据活体检测返回的特征照片id来获取对应的人脸照片

按次计费(¥0.08/次) 调用次数: 0 正常运行 响应速度: <100ms 需要传入API密钥

接口信息

接口地址:
https://api.shuliancloud.com/v2/life/check/image/url
请求方式: GET
返回格式: JSON

调用统计

0
今日调用
0
总调用次数
请求示例 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
}