纷享销客开发者手册 纷享销客开发者手册
  • APL开发手册
  • PWC开发手册
  • OpenAPI 文档
  • 快速入门
  • API 授权流程
  • API 基础说明
  • OpenAPI
  • 免登集成方案
  • 客户端开发
  • 常见问题
  • OpenApi V1版本 (opens new window)
  • 简体中文
  • English
  • 快速入门
  • API 授权流程
  • API 基础说明
  • OpenAPI
  • 免登集成方案
  • 客户端开发
  • 常见问题
  • OpenApi V1版本 (opens new window)
  • 简体中文
  • English
  • 快速入门

  • API授权流程

  • API基础说明

  • OpenAPI

    • CRM对象接口

    • CRM对象通用接口

    • 通讯录接口

    • 其他接口

      • 任务待办接口

      • 考勤外勤接口

      • 协同审批接口

      • 企业互联接口

      • 消息接口

      • 素材管理接口

      • 网盘接口

      • 营销通接口

      • 文件服务

        • 获取大文件下载签名URL
        • 获取文件预签名URL
        • 删除大文件
        • 生成文件预览URL
        • ERP接口

        • BI接口

        • 下线接口

    • 免登集成方案

    • 客户端开发

    • 常见问题

    目录

    生成文件预览URL

    # 描述

    生成文件预览URL

    # 请求说明

    请求方式:POST + application/json

    请求路径:https://${填入所在云的域名}/cgi/crm/v2/generatorPreviewUrl?thirdTraceId=${随机字符串}

    请求头填写 :参考公共参数填写

    # 请求参数

    参数 类型 是否必填 说明
    data Map 是 数据MAP
      paths List[String] 是 文件路径
      expire Int 是 过期时间

    |  fileInfo | Map | 是 | 文件基本信息 | |    path | String | 是 | 文件ID,必须以N_、TN_、C_、TC_开头,长度不超过48 | |    filename | String | 是 | 文件名,最长120字符 | |    extension | String | 是 | 文件扩展名,不带点号。支持预览类型:png,webp,jpeg,jpg,bmp,gif,txt,sql,js,css,csv,json,md,xml,py,java | |  expireTime | Int | 是 | 链接有效期,单位秒。最小值60秒最大值:604800秒 | |  globalAcceleration | Boolean | 否 | 是否开启全球加速,默认false |

    # 请求示例

    {
      "data": {
        "expireTime": "",
        "globalAcceleration": "",
        "fileInfo": {
          "path": "",
          "extension": "",
          "filename": ""
        }
      }
    }
    

    # 返回参数

    参数 类型 说明
    traceId string 请求唯一ID
    errorDescription string 错误描述
    errorMessage string 错误信息
    errorCode Int 查看错误码

    # 返回示例

    {
      "traceId": "E-O.827xxxxxx",
      "errorDescription": "success",
      "errorMessage": "OK",
      "errorCode": 0
    }
    

    # 注意事项

    • 不能使用返回值的message字段做逻辑判断,errorMessage会有变化;
    删除大文件
    ERP提供对外的数据推送接口

    ← 删除大文件 ERP提供对外的数据推送接口→

    • 跟随系统
    • 浅色模式
    • 深色模式
    • 阅读模式