概述
开发者对应的企业在成为“生态伙伴”后,可实现自研开发和代企业客户开发两种能力。
- 自研开发能力:开发者对应的企业在e签宝官网进行实名注册后,即具备自研开发能力,开发者可以基于自己企业的业务场景进行对接开发,可参考人力资源场景-最佳实践案例。
- 代开发能力:开发者对应的企业在e签宝官网进行实名注册,并成为e签宝的“生态伙伴”后,即具备代其他企业客户开发的能力,开发者可以基于其他企业客户的业务场景进行对接开发。
这里,将介绍成为e签宝“生态伙伴”后,如何实现代其他企业客户集成开发的对接方案。
代开发能力
“生态伙伴”需先引导企业客户完成应用授权,并获取到企业客户的授权令牌token;后续的签署业务场景,“生态伙伴”可通过获取到的授权令牌token实现代企业客户开发和管理。
如下图,“生态伙伴”通过应用appid实现代开发,帮助其他企业客户实现线上签署业务。

接入流程
代企业客户开发的流程如下所示,对应步骤的接口调用请参考应用授权接入方案。

开发前准备:“生态伙伴”注册实名并创建应用

沙箱环境使用说明
1、开通沙箱环境
使用e签宝企业账号登录e签宝开放平台(https://open.esign.cn),进入【控制台】-【沙箱服务】后即可开通沙箱环境,获取沙箱环境开发调试权限。
2、创建沙箱应用
开发者登录e签宝开放平台,进入【沙箱服务】创建沙箱应用,用于开发调试。
3、配置沙箱应用IP白名单
开发者登录e签宝开放平台,进入【沙箱服务】找到对应沙箱应用配置IP白名单。沙箱应用配置IP白名单后即可进行API接口集成和调试。
转正式环境使用说明
1、创建正式应用(正式环境上线前准备)
API接口集成调试完毕,开发者登录e签宝开放平台,进入【正式服务】创建正式应用,用于线上生产使用。
2、配置正式应用IP白名单(正式环境上线前准备)
开发者登录e签宝开放平台,进入【正式服务】找到对应正式应用配置IP白名单。正式应用配置IP白名单后即可在线上生产使用。
应用授权对接方案
1、应用授权对接时序图
ISV/开发者对接时需注意:
流程图的步骤7和步骤8-9都可以获取到客户授权的应用ID等信息,由于异步通知会受到网络等因素影响,ISV可以结合自身的业务逻辑去结合异步通知和查询接口来获取客户的授权信息。
2、应用授权接口API列表
接口对接文档请参考:应用授权接入方案
接口名称 | API接口 | 请求方式 |
应用授权邀请 | /v2/sys/getInviteUrl | POST |
查询授权信息 | /v2/sys/getAuthApp | GET |
获取授权令牌token | /v1/oauth2/access_token | POST |
异步通知:应用授权成功回调通知 | POST |
3、应用授权页面流程
(1)授权方通过访问邀请链接,并填写授权方主体信息进行登录并完成实名认证,可参考实名认证操作手册;

(2)实名成功后,点击【立即体验】,并跳转应用授权页面,点击【授权】,完成此次应用授权过程;


4、各行业签署场景-最佳实践列表
行业类型 | 场景名称 | 最佳实践 |
人力资源场景 | 入职材料/公司内部确认材料签署场景 | |
企业证明类文件签署场景 | ||
劳动合同/离职协议等签署场景 | ||
劳动外派/派遣员工劳动合同签署场景 | ||
融资租赁行业 | 融资租赁合同签署场景最佳实践 | |
财务电子回单签署场景最佳实践 | ||
催款通知单签署场景最佳实践 | ||
... | ... | ... |