Skip to content

预览服务

整体流程

pic

接入须知

目前的产品能力是基于飞书文档转接的,产品形态与网盘有很大不同,因此当前能否适用到各业务场景还需要在对接体验过程中评估。

以下差异提醒当前已发现需注意:

  1. 文件允许能用户传阅和下载本地,无法关闭。浏览记录会显示在用户个人最近访问中
  2. 必须有飞书员工账号才能预览
  3. 浏览界面有飞书上边栏和侧边栏的样式。
  4. 支持文档格式:支持doc\ppt\xls新旧版本格式,不支持docm等衍生格式及wps格式。

接口文档

测试

  • 上传文件并获取文件的预览地址

https://api.hisense.com/#/principal/portDetails?id=59408

  • 根据buid获取已上传文件的预览地址

https://api.hisense.com/#/principal/portDetails?id=59440

生产

冯晓东验收完成后提供

签名规则

注意: 通过融合集成平台订阅传递的userKey,不要添加到签名参数中。

Java工程|前端工程

同构签名方式

非Java工程&非前端工程

算法实现: 算法实现文件

调用上传文件接口时,使用方法:

java
    /**
     * 生成文件上传请求签名
     *
     * @param secretKey 密钥
     * @param method    请求方法
     * @param urlParams URL参数
     * @return MD5签名
     */
    public static String generateSign(String secretKey, String method, Map<String, String> headerParams, Map<String, String> urlParams, MultipartFile file) throws IOException;

urlParams无需传值。

调用获取文件预览地址接口时,使用方法:

java
    /**
     * 生成常规请求签名
     *
     * @param secretKey 密钥
     * @param method    请求方法(GET/POST等)
     * @param urlParams URL参数
     * @param body      请求体内容
     * @return MD5签名
     */
    public static String generateSign(String secretKey, String method, Map<String, String> headerParams, Map<String, String> urlParams, String body) throws IOException;

body不传,urlParams中只传buId即可。