上传个人自定义印章图片

接口说明

[!NOTE]
上传个人自定义印章图片，可以用于签署合同。此接口非必调，个人可以在签署合同的时候在线手写签名或者是使用君子签系统自动生成的标准印章完成合同签署。接口不会对上传的印章图片做真实性校验，需要开发者确保真实性。

注：平台上传个人自定义印章图片时，需要先获取到用户的知晓并同意。

http请求方式

[!NOTE]
POST multipart/form-data

http请求地址

[!NOTE]
$SERVICE_URL/v2/user/uploadPersSign #其中$SERVICE_URL为生产或测试的地址

http请求参数

[!NOTE]
除公共必填参数外，还需要传以下参数

参数	类型	是否必填	默认值	说明
identityCard	string	?		个人证件号
signImgFile	file	*		印章图片,png格式,背景透明,建议大小10050PX,接口不对印章图片做真实性校验，需要开发者确保真实性。*
notChinaIDCard	int	?		证件类型，不传时默认为身份证类型；1 为非大陆证件

代码实现

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	string	?	异常时返回

[!NOTE]
返回结果，参考：

//正确响应：
{"success":true}
//错误响应：
{"msg":"手写签字图片为空","resultCode":"HTTP_PARAM_ERROR","success":false}

results matching ""

No results matching ""