企业人脸校验上传
接口说明
[!NOTE]
企业注册认证接口,该接口提供了认证页面,法人或者代理人人脸识别通过后,在线上传营业执照图片完成企业注册认证。
http请求方式
[!NOTE]
POST application/x-www-form-urlencoded
http请求地址
[!NOTE]
$SERVICE_URL/v2/user/organizationFaceCreate #其中$SERVICE_URL为生产或测试的地址
http请求参数
除公共必填参数外,还需要传以下参数
参数 | 类型 | 是否必填 | 默认值 | 说明 |
---|---|---|---|---|
orderNo | string | * | 唯一流水号,由商户自行指定 | |
string | * | 唯一邮箱,由商户自行指定 | ||
enterpriseName | string | * | 企业证件名称 | |
identityNo | string | * | 统一社会信用号 | |
legalPersonName | string | * | 法人名称 | |
legalIdentityCard | string | * | 法人证件号 | |
legalMobile | string | ? | 法人手机号 | |
facePerType | int | * | 验证人类型1代理人,其它法人 | |
faceAgantIdenName | string | * | 人脸验证代理人-名称 | |
faceAgantIdenCard | string | * | 人脸验证代理人-证件号 | |
backUrl | string | * | 回调地址 |
代码实现
JAVA实现
RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
//构建请求参数
Map<String,Object> params=new HashMap<>();
params.put("orderNo","XXXXX");
params.put("email","XXXXX");
params.put("enterpriseName","重XXXXX公司");
params.put("identityNo","500XXXXXXXXXXXX");
params.put("legalPersonName","文XX");
params.put("legalIdentityCard","500XXXXXXXXXXXX");
params.put("legalMobile","153XXXXXXXX");
params.put("facePerType",1);
params.put("faceAgantIdenName","易XX");
params.put("faceAgantIdenCard","500XXXXXXXXXXXX");
params.put("backUrl","http://xxx.xxx.xxx");
ResultInfo<String> ri= requestUtils.doPost("/v2/user/organizationFaceCreate",params);
PHP实现
//构建请求工具
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
//CURLFile 可以传url或filePath,但必须保证文件存在且有效,否则php不会报错,只会导致http请求返回null(并没有调到服务端)。
//初始化合同参数
$request=new OrganizationCreateReq();
$request->name="重XXXXX公司";
$request->identificationType=1;
$request->organizationType=0;
$request->organizationRegNo="500XXXXXXXXXXXX";
$request->organizationRegImg= new CURLFile('D:/tmp/test.png',null,"test.png");
$request->legalName="易XX";//法人
$request->legalIdentityCard="500XXXXXXXXXXXX";//法人证件号
$request->legalMobile="153XXXXXXXX";
//发起创建企业请求
$response=$requestUtils->doPost("/v2/user/organizationCreate",$request);
http返回参数
[!NOTE]
返回response为application/json的数据,其字段说明如下
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
success | bool | * | 成功true;异常false |
msg | string | ? | 异常时,返回异常原因 |
resultCode | string | ? | 异常时返回 |
data | string | ? | 企业人脸验证地址,成功时返回 |
[!NOTE]
返回结果,参考:
//正确响应:
{"data":"http://xxx.xx.xx","success":true}
//错误响应:
{"msg":"app_secret不可用","resultCode":"HTTP_PARAM_ERROR","success":false}