智汇云-企业数智化核心引擎

#接口说明
## 人脸实名认证
本文提供了调用人脸实名认证的具体接口和参数说明。温馨提示：调用此服务API需登录智汇云官网进行开通，https://zyun.360.cn/manage

### 接口名
/v1/faceid/silentIdnumberVerification
### 请求域名
- ai.zyun.360.cn
- 请求方法
  post

### 功能描述
比对上传的人脸活体视频与上传的身份证信息是否一致，进而进行用户人脸实名认证信息。

### 通讯协议
支持通过HTTP协议进行请求通信
### 请求方式 
支持post方式发送请求

### 请求参数
#### Header头中传递的参数

|参数 |参数名 |参数描述|
| ------------ | ------------ | ------------ |
|Authorization |鉴权信息 |鉴权信息规则参见下方规则详细描述。|
|Auth-Time| 当前时间 |规则参见下方详细描述。|
|Rand-Num |随机数 |规则参见下方详细描述。|
|Auth-Ver |版本号 |固定值:1.0|

####header认证参数说明 
|参数名称 |说明| 用法|
| ------------ | ------------ |
|Authorization|认证字符串| 生成第一步：将AK、auth_time、rand_num、param_sign 拼接成一个字符串、中间用"\n"分隔。第二步：用SK对第一步生成的字符串做sha1加密，生成authorization |
|Auth-Ver|认证版本| 1.0 | 
|Auth-Time|认证时间| 表示此次操作的时间，unix系统时间戳（10位）(不能为空，如果请求中的Auth-Time时间和服务器的时间差15分钟以上，服务器将拒绝该服务，并返回ERROR错误) | 
|Rand-Num|随机正整数| 表示一个随机正整数(rand生成即可) |

##Authorization生成规则
```
$auth_time      = time();
$auth_string    = $ak . "\n" . $auth_time . "\n" . $rand_num . "\n" . $param_sign;
$encrypt_string = base64_encode(hash_hmac("sha1", $auth_string, $sk, true));
$authorization  = $ak . ":" . $encrypt_string;

```
###构造密码串
|参数说明 |参数名称 |说明| 用法|
| ------------ | ------------ |
|auth_time |unxi时间戳(10位)| |
|ak |Access Key| 官网用户中心查看 https://zyun.360.cn/usercenter/user/accesskey | 
|sk |Secret Access Key| 官网用户中心查看 https://zyun.360.cn/usercenter/user/accesskey| 
|rand_num |随机正整数| | 
|param_sign|参数按键排序并加入随机因子| 所有参数按key做升序排序后串成字符串$paramStr，然后 $paramStr的md5值连上$rand_num，然后再用md5计算得到的值为param_sign paramStr排序例子： 参数 { a1:v1, b1:v3, a2:v2 } 排序后的字符串为 a1=v1a2=v2b1=v3 |

#### body中传递的参数（post）

| 参数名称 | 必选 |类型 | 参数说明 |
| ------------ | ------------ | ------------ |
|video_file |true | File |待检测视频文件，该字段不参与签名 |
|name |true | string| 姓名|
|idnumber |true | string| 身份证号|
|app_id |true | string| 在人脸与人体识别控制台中创建的应用ID|
|return_image |false | bool| 是否返回判定用的图片Base64编码，默认false|

### 返回结果说明
####同步返回结果说明

|参数名称| 必选 |类型| 参数说明|
| ------------ | ------------ | ------------ |
|errcode |true| int | 错误码 |
|errmsg |true | string| 错误描述 |
|data | true | json | 响应结构体 |

####data结构
|参数名称| 必选 |类型| 参数说明|
| ------------ | ------------ | ------------ |
|taskid |true| string | 任务ID |
|cost | true | float | 耗时 |
|result| true |json | 检测结果 |

####result结构
|参数名称| 必选 |类型| 参数说明|
| ------------ | ------------ | ------------ |
|pass|false| bool | 处理结果，true:通过， false:未通过 |
|verification_score|true|float| 人脸比对得分 |
|liveness_status|true | string |静默活体检测状态描述 |
|image_id|true |string| 云端存储的视频选帧图片ID |
|image_timestamp| true |string| 视频选帧时间戳，默认秒 |
|base64_image| true |string| base64编码后的图片文件流|

###同步响应示例

```

{

"errcode": 0,

"errmsg": "ok",

"data": {

"taskid": "TID_FID_2019111568383939844",

"cost": 0,

"result": {

"passed": true,

"verification_score": 0.83,

"liveness_status": "ok",

"image_id": "20ebc4ed93af4557bbd6e4fc93c5eca3",

"image_timestamp": 1.2566333333333335,

"base64_image": "",

}

```

### 错误码说明
|错误码 |说明|
| ------------ | ------------ | 
|0 |正常|
|400001|未知错误|
|400002|系统内部错误|
|400003|签名错误|
|400004|参数错误|
|440021|无效的视频文件|
|440022|视频文件类型不支持|
|440023|视频文件大小不支持|
|440031|return_image 参数格式错误|
|440033|身份证号码错误|
|440034|姓名与身份证号不匹配|
|440035|姓名错误|

AI大模型

AI平台

AI应用

视频

物联网

数据上云

IoT设备

账号体系

智慧城市

电商视频解决方案

教育

全屋智能

医疗

智能制造

游戏

人脸识别

电话咨询：

服务咨询

建议反馈

产品与服务

文档与社区

关于我们

关注我们

请您联系我们

小安提醒您

1对1免费 咨询智汇云专属顾问

为您量身定制产品解决方案

1对1免费咨询智汇云专属顾问