跳到主要内容

测试环境联调准备

环境说明

在您的账号注册完成,企业认证完成之后,在应用的开发阶段,推荐您使用测试环境的企业进行开发和联调。

测试环境用于前期的开发阶段,进行接口联调和功能测试。测试环境与生产环境数据隔离,需要重新认证测试环境的企业。本文档会帮助您完成测试环境的创建,并了解第三方应用的相关配置。

创建第三方应用

进入PC 端控制台登录,访问【企业应用管理】 > 【应用集成】,在这里可以管理您的应用相关配置。

在第三方应用集成中,点击添加应用,即可看到弹出应用信息的创建界面。

创建应用,输入应用的配置信息。

创建测试环境企业

接上一步,在创建好的第三方应用上,点击测试联调按钮,即可看到测试联调环境的创建方法。

在创建好的应用上,点击测试联调按钮,即可看到测试联调环境的创建方法,根据指引即可创建对应的测试联调企业。

点击之后打开弹窗,根据弹窗中的文字指引,扫描二维码将会进入腾讯电子签 Demo 小程序,并自动进入企业认证流程。

测试环境企业创建完成之后,接下来的操作,我们将在测试环境企业中进行。

提示

创建第三方应用,需要先开通腾讯电子签专业版。若您未购买专业版,导致无法创建测试企业,可以在自建应用版块中点击测试联调按钮,创建测试环境企业。效果一致。参考自建应用 - 测试环境联调准备 - 创建测试企业

参数配置

打开测试环境-企业控制台,访问 【企业应用管理】 > 【应用集成】 > 【第三方应用】。

参考创建第三方应用这一步,再次创建测试环境下的第三方应用。

在创建好的第三方应用上,点击测试联调按钮,此时将会弹出参数配置弹窗界面,

参数配置中可以进行回调地址的配置,请注意提供的回调地址能够公网访问,能接受处理 http post 请求,并返回状态码 200 标识处理正常。

回调消息加密 key、签名验证 token 可以单击系统生成。确认配置后即刻生效。更多关于回调通知的信息请参见 查看回调通知文档

在签名验证 token 上,选择点击系统生成可以随机生成解密的 Key,用于回调签名验证。

此处支持配置多个回调地址并同时生效。

获取密钥

访问 【企业应用管理】 > 【应用集成】 > 【第三方应用】>【测试联调】> 【获取密钥】

密钥指的是 SecretId 和 SecretKey,是用来识别企业身份和接口鉴权的必要参数。密钥是重要的参数,需要妥善保管,防止泄露。

应用扩展

访问 【企业应用管理】 > 【应用集成】 > 【第三方应用】>【测试联调】> 【应用扩展服务】

可以开通下载应用内全量合同文件及内容数据。

开通后,将支持通过 API 接口下载应用内全量的合同文件,也可查询获取合同中内容数据

接口联调

测试环境联调域名

测试环境接口请求域名(EndPoint)
essbasic.test.ess.tencent.cn

文件上传域名 - UploadFiles接口使用
file.test.ess.tencent.cn

平台企业控制台域名
https://beta.qian.tencent.cn

若使用 SDK 设置域名的时候,需要将域名设置到EndPoint参数中。参考 java 的设置代码如下

HttpProfile httpProfile = new HttpProfile();
httpProfile.setEndpoint("essbasic.test.ess.tencent.cn");

ClientProfile clientProfile = new ClientProfile();
clientProfile.setHttpProfile(httpProfile);

测试环境控制台

进入测试环境控制台 - https://beta.qian.tencent.cn/console/,测试环境的页面标题上带有预览字样,用以区分。

测试环境小程序

可扫描下方二维码进入腾讯电子签 Demo 小程序。

提示

Demo 小程序中,签署的合同无任何法律效力。进入小程序中,输入“我已知晓以上内容”,即可进入体验。