深色模式
控制台
回调接口可以理解为文件系统的接口抽象,需要接入方提供文件元信息,文件下载地址,文件权限,文件保存等接口,用于打通在线编辑系统与文件系统。当然,接入方可以通过签发凭证(Token)的方式,自行管理文件系统的权限。 详情见 回调概述
假设网关地址为https://www.****.com:####
,回调接口地址是 /v3/3rd/files/${file_id}
,则完整的回调接口地址就是 https://www.****.com:####/v3/3rd/files/${file_id}
。 通过 API 列表最后的 “调试” 按钮,可以用来测试你的服务,能否被 WebOffice 服务器 访问到,这一点很关键。
详见 回调网关
针对每一个实现的回调接口,可以在线测试该接口是否可以正常访问。
token、file_id 从哪获取?
参数 | 说明 |
---|---|
token | 接入业务方根据自身的鉴权需要进行自定义,在前端 初始化 SDK 时传入, WebOffice 将会在回调接入业务方接口时通过 Header 的 X-Weboffice-Token 字段回传,业务方可通过请求Header 获取,用于鉴权。 |
file_id | 1. file_id 是由对接企业自己生成并管理,需要保证一个 file_id 对应一个文件,也对应一个文件的多个版本; 2.file_id 建议使用字母与数字的格式,使用 #$%^&*_ 等与其他特殊符号会引起异常错误; |