智汇云-深化数据价值，助力数字未来

#接口说明
## 人脸实名认证
本文提供了调用人脸实名认证的具体接口和参数说明。温馨提示：调用此服务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|姓名错误|

存储服务

视频应用

视频工具

内容审核

人脸与人体识别

OCR识别

图像技术

AI开发平台

AI市场

物联网视频

物联网平台

生活物联网平台

物联网边云融合

网络与CDN

应用开发

研发效能

视频应用

企业工具

安全应用

云计算

大数据

智能网关

容器服务

AI开发平台

视频

物联网

数据上云

IoT设备

账号体系

智慧城市

电商视频解决方案

教育

全屋智能

医疗

智能制造

游戏

人脸识别

电话咨询：

热门产品

帮助文档

服务条款

关注或联系我们

请您联系我们

小安提醒您

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

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

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