接口描述
开发者通过该接口给当前需要签署的企业用户创建签署账号,并获取对应的企业签署账号ID。
开发者在对接过程中,需注意:
- 开发者需要把《数字证书服务协议》展示到自身页面内,用户浏览勾选同意后才可以帮助用户生成e签宝签署账号(点击查看 《数字证书服务协议》模板),详见《电子签名使用合规性处理说明》。
- 该接口只对证件号格式进行格式校验,不对企业信息的真实性进行校验,建议开发者提前接入企业二要素信息比对接口确认信息准确后再创建企业签署账号,详见 《组织机构2要素信息比对》。
接口名称
AccountService.addAccount(OrganizeParam organize)
请求参数
展开全部参数参数名称 | 参数类型 | 必选 | 参数说明 | |
organize(点击“+”展开详情) | OrganizeParam | 是 | 企业信息详情 | |
name | String | 是 | 企业名称 | |
regType | OrganRegTypeEnum | 是 | 企业证件类型,支持的类型如下:
| |
orgCode | String | 是 | 企业证件号 | |
encrypt | boolean | 否 | 用户信息是否加密传输,默认 false
|
响应参数
展开全部参数参数名称 | 参数类型 | 必选 | 参数说明 | |
addAccountResult(点击“+”展开详情) | AddAccountResult | 是 | 响应结果类 | |
errCode | int | 是 | 错误码,0标识成功,其他均标识失败 | |
msg | String | 否 | 错误信息,错误码对应的说明信息 | |
errorShow | boolean | 否 | 错误信息是否建议显示 | |
accountId | String | 否 | 企业账号ID,后续通过该账号进行企业用户签署 (在当前应用ID下唯一) |
请求示例
public static void main(String[] args) {
//获取客户端的代码:
ServiceClient getKHD = ServiceClientManager.get("您的pojectId");
AccountService service = getKHD.accountService();
// 创建企业账号
AddAccountResult addAccountResult = service.addAccount(addOrganizeAcct());
if (addAccountResult.getErrCode() != 0)
System.out.println("创建企业账号失败:" +addAccountResult.getMsg());
else
System.out.println("创建企业账号成功,e签宝平台对应的账号标识是:"+ JSONObject.fromObject(addAccountResult));
}
/**
* 创建企业签署账号
*/
private static OrganizeParam addOrganizeAcct() {
OrganizeParam organize = new OrganizeParam();
organize.setName("*****科技有限公司");//机构名称,不可空
organize.setOrgCode("5222******L62");// 统一社会信用代码号或工商注册号
organize.setRegType(OrganRegTypeEnum.MERGE);// 企业证件类型,MERGE:统一社会信用代码(多证合一),REGCODE:企业工商注册码
return organize;
}
响应示例
{
"msg": "成功",
"accountId": "AD12C99D1661119CABFA89BABDF6E8FA",
"errCode": 0,
"errShow": false
}