重要术语
在和每个应用集成前,业务系统的集成人员,需要确定:业务系统id、业务系统回调context。
文档ID (docId)
即docId。三方系统中的每一个文件都必须要有唯一的文档id。同一个文件,同一个id。三方系统请求在线编辑/预览服务时,需要指定编辑/预览的docId。
重要说明:
- docId 是标识文件的Id,字符串类型
- 不能有冒号
: - 不能出现一个id对应不同的文件,一会是word文件,一会又变成pdf文件
- 不能出现同一个文件,这次编辑是这个id,下次编辑又是另一个id
业务系统ID (appId/repoId)
三方系统请求在线编辑/预览服务时,需要指定当前请求的appId。
说明:
- 这个id需要在Filez文档中台配置
三方业务系统回调Context
三方业务系统需要提供文件上传和下载地址,其地址的前缀(必须包括host)需要在Filez文档中台配置。
示例,如果配置context为:
http://my.integration.com
这时请求初始化配置中的downloadUrl、uploadUrl必须以 http://my.integration.com 开头。
前端SDK集成方式的配置
- 登录管理控制台(docs/app/admin),默认密码为admin。


- 点击集成应用进入集成配置页面

- 点击新增应用进入新增应用页面

- 填写应用信息:
三方应用id和三方应用接口地址为必填项,其他选填。三方应用接口地址会约束回调三方接口的前缀。三方应用接口token名称默认值为zdocs_access_token(无需修改)。
点击开启前端SDK集成填写集成加密密钥。可以用下列命令来产生:
openssl rand -base64 64
该密钥需要同时保存到业务系统服务端。点击下方添加应用,可同时添加多个应用集成。

- 填写完毕后,点击保存。可以看到新的应用出现在应用列表中。
