个人证书申请资料上传
接口说明
[!NOTE]
个人申请CA证书需上传的资料,接口不对传入的个人信息做真实性校验,需要开发者确保真实性。
http请求方式
[!NOTE]
POST multipart/form-data
http请求地址
[!NOTE]
$SERVICE_URL/v2/user/cloudCertiPerInfo #其中$SERVICE_URL为生产或测试的地址
http请求参数
除公共必填参数外,还需要传以下参数
参数 | 类型 | 是否必填 | 默认值 | 说明 |
---|---|---|---|---|
fullName | string | * | 用户名称 | |
identityCard | string | * | 用户证件号 | |
idenFront | file | * | 身份证人像面,图片大小控制在500KB以内 | |
idenReverse | file | * | 身份证国徽面,图片大小控制在500KB以内 | |
applyTable | file | ? | 申请表可以不用传 | |
certSn | string | ? | 证书sn | |
busId | string | ? | 第三方核验流水号 | |
requestParam | string | ? | 第三方核验请求参数(json字符串格式),参考示例:{\"idCard\":\"51xxxxxxxxxxxxxxxx\",\"mobile\":\"152xxxxxxxx\",\"name\":\"袁xx\",\"type\":21} | |
resultParam | string | ? | 第三方核验响应参数(json字符串格式),参考示例:{\"code\":\"10000\",\"match\":1,\"message\":\"验证成功\",\"transitionId\":\"lo1y2p0ij32e855OO1y2ozy0akhfup\"} | |
verifyTime | string | ? | 核验时间精确到时分秒建议格式(yyyy-MM-dd HH:mm:ss)或(yyyyMMddHHmmss) |
代码实现
JAVA实现
RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
//构建请求参数
Map<String,Object> params=new HashMap<>();
params.put("fullName","易XX");
params.put("identityCard","5002401XXXXXXXXXXXX");
params.put("idenFront", new FileBody(new File("/tmp/test.png")));//
params.put("idenReverse", new FileBody(new File("/tmp/test.png")));//
//params.put("applyTable", new FileBody(new File("/tmp/test.png")));//
ResultInfo<Void> ri= requestUtils.doPost("/v2/user/cloudCertiPerInfo",params);
PHP实现
//构建请求工具
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
//初始化合同参数
$request=array(
"fullName" => "易XX", //TODO *
"identityCard" => "500XXXXXXXXXXXX", //TODO *
"idenFront" => new CURLFile('D:/tmp/test.png',null,"test.png"),
"idenReverse" => new CURLFile('D:/tmp/test.png',null,"test.png"),
//"applyTable" => new CURLFile('D:/tmp/test.png',null,"test.png"),
);
//发起请求
$response=$requestUtils->doPost("/v2/user/cloudCertiPerInfo",$request);
http返回参数
[!NOTE]
返回response为application/json的数据,其字段说明如下
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
success | bool | * | 成功true;异常false |
msg | string | ? | 异常时,返回异常原因 |
resultCode | string | ? | 异常时返回 |
[!NOTE]
返回结果,参考:
//正确响应:
{"success":true}
//错误响应:
{"msg":"名称不能为空","resultCode":"HTTP_PARAM_ERROR","success":false}