由于e签宝官方提供的demo,杂乱无章并且没有进行API接口的封装,加密方式也比较特殊,导致开发接入成本很高。
所以特意进行了封装,方便开发人员快速接入。节省时间。
也欢迎大家对其他接口进行扩展。
一、编辑pom.xml文件,添加以下依赖
<dependency>
<groupId>cn.psoho</groupId>
<artifactId>fastesign-starter</artifactId>
<version>1.3.5</version>
</dependency>
二、增加以下配置
fastesign:
appId: 511******46
secret: 603***************269f
三、开始使用
public class EsignTest {
@Autowired
FastEsignService esignService;
String docTemplateId = "d2dcab327b4******dfd1d7dd17";
@Test
void docTemplate() {
EsignResponse<DocTemplateResponse> r = esignService.getDocTemplateService().get(docTemplateId);
log.info("返回: r={}", JsonUtils.toPrettyJson(r));
}
}
目前只封装了最常用的API接口,如果不满足需求,自己扩展新接口即可。
扩展非常方便,对照e签宝的文档,定义好请求和响应实体bean,扩展对应的service方法即可。
建议参考官方文档标准来扩展:
https://open.esign.cn/tools/api-debug
示例如下
/**
* 签署
*/
@RequiredArgsConstructor
public class SignFlowService {
final FastEsignService fastEsignService;
/**
* 填写模板生成文件
*
* @param request
* @return
*/
public EsignResponse<FilesCreateByDocTemplateResponse> filesCreateByDocTemplate(FilesCreateByDocTemplateRequest request) {
String path = "/v3/files/create-by-doc-template";
return fastEsignService.post(path, request, FilesCreateByDocTemplateResponse.class);
}
}