上传个人自定义签名图片
服务说明
[!NOTE] 上传个人自定义手写签名图片或者是个人公章图片,可以用于签署合同。此接口非必调,个人可以在签署合同的时候在线手写签名或者是使用君子签系统自动生成的标准印章完成合同签署。
http请求方式
[!NOTE] POST multipart/form-data
http请求地址
[!NOTE] $SERVICE_URL/v2/user/uploadPersSign #其中$SERVICE_URL为生产或测试的地址
http请求参数
参数 | 类型 | 是否必填 | 默认值 | 说明 |
---|---|---|---|---|
identityCard | string | ? | 个人证件号 | |
signImgFile | file | * | 公章图片,png透明图片,需自行扣章后上传 |
代码实现
JAVA实现
RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
//构建请求参数
Map<String,Object> params=new HashMap<>();
params.put("identityCard","XXXXX");
params.put("signImgFile",new FileBody(new File("/tmp/test.png")));
ResultInfo<Void> ri= requestUtils.doPost("/v2/user/uploadPersSign",params);
log.info("请求结果:"+ JSONObject.toJSONString(ri));
PHP实现
//构建请求工具
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
//初始化合同参数
$request=array(
"identityCard" => "500XXXXXXXXXXXX", //TODO *
"signImgFile" => new CURLFile('D:/tmp/test.png',null,"test.png"),//php5.3-php5.6请使用@.方式
);
$response=$requestUtils->doPost("/v2/user/uploadPersSign",$request);
http返回参数
[!NOTE] 返回response为application/json的数据,其字段说明如下
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
success | bool | * | 成功true;异常false |
msg | string | ? | 异常时,返回异常原因 |
resultCode | int | * | 成功0,其它参考附录 |
data | object | ? | 公章文件信息 |
[!NOTE] data 为JSON结构,其字段说明如下
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
entSignDate | string | * | 公章文件内容base64String字符串 |
[!NOTE] 返回结果,参考:
//正确响应:
{"success":true}
//错误响应:
{"msg":"手写签字图片为空","resultCode":"HTTP_PARAM_ERROR","success":false}