申请保管函
接口说明
[!NOTE]
保管函申请接口
http请求方式
[!NOTE]
POST application/x-www-form-urlencoded
http请求地址
[!NOTE]
$SERVICE_URL/v2/sign/safeKeepLetterApply #其中$SERVICE_URL为生产或测试的地址
http请求参数
除公共必填参数外，还需要传以下参数
| 参数 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| applyNo | string | * | 合同编号（合同发起接口中返回的APL编号） | |
| fullName | string | * | 签约人名称（合同发起接口中传入的签署人姓名） | |
| identityCard | string | * | 签约人证件号（合同发起接口中传入的签署人证件号） | |
| identityType | int | * | 证件类型 1身份证, 2护照, 3台胞证, 4港澳居民来往内地通行证, 11营业执照, 12统一社会信用代码, 20子账号, 99其他 |
代码实现
JAVA实现
RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
//构建请求参数
Map<String,Object> params=new HashMap<>();
params.put("applyNo","APL0000XXXXXX"); //TODO * 合同编号
params.put("fullName","易XX");
params.put("identityCard","500240XXXXXXXXXXXXXXX");
params.put("identityType",1);
ResultInfo<String> ri= requestUtils.doPost("/v2/sign/safeKeepLetterApply",params);
http返回参数
[!NOTE]
返回response为application/json的数据，其字段说明如下
| 参数 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| success | bool | * | 成功true；异常false |
| msg | string | ? | 异常时，返回异常原因 |
| resultCode | string | ? | 异常时返回 |
[!NOTE]
返回结果，参考：
//正确响应：
{"success":true}
//错误响应：
{"msg":"电子保管函执行失败:null-申请保管函失败","resultCode":"BUSINESS_ERROR","success":false}