保全后合同文件及证据包下载
接口说明
[!NOTE]
合同签署完成后,系统会自动对签署的合同文件进行保全存证且生成证据包,该接口可用于保全后合同文件的下载 或者 是证据包的下载,注意:返回的下载URL有效期为30分钟。
http请求方式
[!NOTE]
POST application/x-www-form-urlencoded
http请求地址
[!NOTE]
$SERVICE_URL/v2/sign/presLinkFile #其中$SERVICE_URL为生产或测试的地址
http请求参数
除公共必填参数外,还需要传以下参数
参数 | 类型 | 是否必填 | 默认值 | 说明 |
---|---|---|---|---|
applyNo | string | * | 合同编号(合同发起接口中返回的APL编号) | |
fullName | string | * | 签约人名称(合同发起接口中传入的签署人姓名) | |
identityCard | string | * | 签约人证件号(合同发起接口中传入的签署人证件号) | |
identityType | int | * | 证件类型 1身份证, 2护照, 3台胞证, 4港澳居民来往内地通行证, 11营业执照, 12统一社会信用代码 | |
dealType | String | * | 下载类型,0合同文件,1证据包文件 |
代码实现
JAVA实现
RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
//构建请求参数
Map<String,Object> params=new HashMap<>();
params.put("applyNo","XXX"); //TODO *
params.put("fullName","易XX");
params.put("identityCard","500240XXXXXXXXXXXXXXX");
params.put("identityType",1);
params.put("dealType",1);//下载类型,0合同文件,1证据包文件
ResultInfo<JSONObject> ri= requestUtils.doPost("/v2/sign/presLinkFile",params);
http返回参数
[!NOTE]
返回response为application/json的数据,其字段说明如下
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
success | bool | * | 成功true;异常false |
msg | string | ? | 异常时,返回异常原因 |
resultCode | string | ? | 异常时返回 |
data | string | ? | 合同文件或证据包文件下载url地址 |
[!NOTE]
返回结果,参考:
//正确响应:
{"data":"https://s.junziqian.com/fileOper/download?ts=170899XXXXXXXX","success":true}
//错误响应:
{"msg":"查询不到签约方信息","resultCode":"SIGN\_INFO\_NOT\_EXISTS","success":false}