H5人脸视频下载
接口说明
[!NOTE]
H5人脸认证后,君子签提供人脸视频的下载,建议收到人脸后等过半分钟再进行下载,视频只临时缓存3天,如有需要请及时拉取自行保存。(不支持小程序人脸接口视频下载)
http请求方式
[!NOTE]
POST application/x-www-form-urlencoded
http请求地址
[!NOTE]
$SERVICE_URL/v2/auth/h5FaceVideoDownload #其中$SERVICE_URL为生产或测试的地址
http请求参数
除公共必填参数外,还需要传以下参数
参数 | 类型 | 是否必填 | 默认值 | 说明 |
---|---|---|---|---|
orderNo | string | * | 人脸订单号 |
代码实现
JAVA实现
RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
//构建请求参数
Map<String,Object> params=new HashMap<>();
params.put("orderNo","XXXXXXX");
ResultInfo<Map<String,Object>> ri= requestUtils.doPost("/v2/auth/h5FaceVideoDownload",params);
PHP实现
//构建请求工具
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
//初始化合同参数
$request=array(
"orderNo" => "XXXXXXX", //TODO *
);
//发起请求
$response=$requestUtils->doPost("/v2/auth/bankFourVerify",$request);
http返回参数
[!NOTE]
返回response为application/json的数据,其字段说明如下
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
success | bool | * | 成功true;异常false |
msg | string | ? | 异常时,返回异常原因 |
resultCode | string | ? | 异常时返回 |
data | object | ? | 返回业务内容 |
data参数说明
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
faceVideo | string | * | 视频记录,为byte[]的Base64String |
[!NOTE]
返回结果,参考:
//正确响应:
{"data":{"faceVideo":"XXXXXX===="},"success":true}
//错误响应:
{"msg":"app_secret不可用","resultCode":"HTTP_PARAM_ERROR","success":false}