联调环境配置
一. 介绍说明
在您的账号注册完成,企业认证完成之后,在应用的开发阶段,推荐您使用测试环境的企业进行开发和联调。
测试环境用于前期的开发阶段,进行接口联调和功能测试。测试环境与生产环境数据隔离,需要重新认证测试环境的企业。本文档会帮助您完成测试环境的创建,并了解第三方应用的相关配置。
二. 联调环境
1.创建第三方应用(联调环境)
进入PC 端控制台登录,访问【企业应用管理】 > 【应用集成】,在这里可以管理您的应用相关配置。
在第三方应用集成中,点击添加应用,即可看到弹出应用信息的创建界面。
创建应用,输入应用的配置信息。
2.第三方应用配置(联调环境)
打开测试环境-企业控制台,访问 【企业应用管理】 > 【应用集成】 > 【第三方应用】。
在创建好的第三方应用上,点击测试联调按钮,此时将会弹出参数配置弹窗界面,
在参数配置中可以进行回调地址的配置,请注意提供的回调地址能够公网访问,能接受处理 http post 请求,并返回状态码 200 标识处理正常。
回调消息加密 key、签名验证 token 可以单击系统生成。确认配置后即刻生效。更多关于回调通知的信息请参见 查看回调通知文档 。
在签名验证 token 上,选择点击系统生成可以随机生成解密的 Key,用于回调签名验证。
此处支持配置多个回调地址并同时生效。
3.获取密钥SecretId和SecretKey(联调环境)
访问 【企业应用管理】 > 【应用集成】 > 【第三方应用】>【测试联调】> 【获取密钥】
密钥指的是 SecretId 和 SecretKey,是用来识别企业身份和接口鉴权的必要参数。密钥是重要的参数,需要妥善保管,防止泄露。
4.第三方应用扩展配置(联调环境)
访问 【企业应用管理】 > 【应用集成】 > 【第三方应用】>【测试联调】> 【应用扩展服务】
可以开通下载应用内全量合同文件及内容数据。
开通后,将支持通过 API 接口下载应用内全量的合同文件,也可查询获取合同中内容数据
5.请求地址(联调环境)
A. 控制台地址(联调环境)
B.小程序二维码(联调环境)
C. 接口请求地址(联调环境)
环境 | 地址 | 说明 |
---|---|---|
文件服务的EndPoint | file.test.ess.tencent.cn | UploadFiles接口使用 |
通用接口请求EndPoint | essbasic.test.ess.tencent.cn | 除UploadFiles外其他接口使用 |
若使用 SDK 设置域名的时候,需要将域名设置到EndPoint
参数中。参考 java 的设置代码如下
- 通用接口请求的设置方式
HttpProfile httpProfile = new HttpProfile();
httpProfile.setEndpoint("essbasic.test.ess.tencent.cn");
ClientProfile clientProfile = new ClientProfile();
clientProfile.setHttpProfile(httpProfile);
// 然后调用ChannelCreateFlowByFiles接口
- 文件接口(UploadFiles)请求的设置方式
HttpProfile httpProfile = new HttpProfile();
httpProfile.setEndpoint("file.test.ess.tencent.cn");
ClientProfile clientProfile = new ClientProfile();
clientProfile.setHttpProfile(httpProfile);
//然后调用CreateFlow等通用接口