跳到主要内容

通用参数

名称说明​

接口Agent参数含义必看

第三方应用平台企业​

指接入方企业，也是一个Saas企业，通过自己的平台接入电子签第三方应用集成。在平台上引导子客企业开通电子签、管理子客模板、印章等，然后代子客企业发起签署流程。

第三方平台应用应用（App）​

一个应用就是一个业务系统。平台要引入子客企业，必须要建立在应用下。例如财务系统。

第三方平台应用应用Id（AppId）​

应用的唯一标识，对应通用参数AppId。不同的业务系统可以采用不同的AppId，不同AppId下的数据是隔离的。联调/生产环境都是可以由控制台开发者中心-应用集成自主生成。应用集成说明（第三方应用集成）

AK/SK​

即secretId/secretKey，调用云API需要使用的密钥对，是平台企业的密钥对（子客企业无需准备此参数）。联调/生产环境都是可以由平台企业电子签控制台应用集成模块自主获取。应用集成说明（第三方应用集成）

子客企业（合作企业）​

是通过第三方平台引入开通电子签的企业账号，是被代理发起签署流程的企业账号。一个营业执照对应一个子客企业主体（ProxyOrganizationName）。在子客企业开通电子签后，会生成唯一的子客应用Id（ProxyAppId）用于代理调用时的鉴权（回调通知-电子签开通通知里会返回此数据ProxyAppId）。

子客企业OpenId（OrganizationOpenId）​

简称OrgOpenId，对应通用参数ProxyOrganizationOpenId。是第三方平台自定义，对于子客企业的唯一标识。一个子客企业主体与子客企业ProxyOrganizationOpenId是一一对应的，不可更改，不可重复使用。（比如，可以使用企业名称的hash值，或者社会统一信用代码的hash值，或者随机hash值，需要第三方平台应保存），最大64位字符串。

子客企业员工/经办人​

子客企业中的员工/经办人，通过第三方平台进入电子签完成实名、且被赋予相关权限后，可以参与到企业资源的管理或签署流程中。

子客企业员工/经办人OpenId（OperatorOpenId）​

简称员工/经办人OpenId。对应通用ProxyOperator中的参数OpenId。是第三方平台自定义，对子客企业员的唯一标识。一个OpenId在一个子客企业内唯一对应一个真实员工，不可在其他子客企业内重复使用。（比如，可以使用经办人企业名+员工身份证的hash值，需要第三方平台保存），最大64位字符串。

平台企业控制台​

平台企业从ess.tencent.com通过微信扫码登录（需要在电子签小程序先登录），管理第三方应用平台相关功能，如控件库、平台企业模版等。

子客企业控制台子客企业​

通过<生成控制台链接>得到的url进入，管理子客企业的经办人、印章、模版等。无法通过扫码登录。

参数定义​

UserInfo​

名称类型必选描述
OpenIdString是经办人（操作员）Id，参考名称说明OpenId

Agent​

名称类型必选描述
AppIdString是腾讯电子签颁发给第三方应用平台的应用ID，32位字符串,参考名称说明AppId
ProxyAppIdString否腾讯电子签颁发给子客企业的应用ID,参考名称说明ProxyAppId
ProxyOperatorUserInfo否子客企业经办人（操作员）,参考名称说明ProxyOperator
ProxyOrganizationOpenIdString否子客企业的企业ID,参考名称说明ProxyOrganizationOpenId

所有接口都会用到通用参数，概念请参考名称说明，建议企业的经办人使用超管用户，即回调通知-电子签开通通知中的ProxyOperatorOpenId