接口开发流程
业务实现接口
图3 预览与业务关系图
预览服务与业务系统之间为协作关系,业务系统作为预览的文件提供方,需要对用户身份鉴权、文件权限鉴权。实现接口如下:
获取文件信息
接口描述
描述:获取文件信息。
API地址:/v1/3rd/fileinfo
调用方法:GET
此接口必须由业务系统自行开发实现
输入参数
参数名
参数类型
数据类型
描述
可选
signature
query
string
请求签名
否
appid
query
string
应用id
否
query
按照需求传入参数
是
输出参数
参数名
数据类型
描述
可选
code
int
返回处理的错误码,当statuscode不为200时,必须返回对应的错误信息 (返回码参照下表)
否
uniqueId
string
文档唯一id,建议用文档sha1,预览服务通过这个id来判断预览文件是否已经生成。必须返回。
否
fname
string
文件的名字,包含后缀,预览服务根据文档名的后缀来判断是否