服务接入方式

预览服务接入基本规则

预览地址拼接方式    https://api.hidocs.cn/api?furl=<furl>

接入说明

1、“ https://api.hidocs.cn/api?furl= ” 为hidocs预览请求主体

2、<furl>为要预览的文件地址（通过浏览器可以直接访问到该文档）

3、支持https协议 即 https://api.hidocs.cn/api?furl=

接入示例

要预览文件地址为：https://www.hidocs.cn/testfiles/hidocs产品白皮书.docx

则完整预览请求url示例：https://api.hidocs.cn/api?furl=https://www.hidocs.cn/testfiles/hidocs产品白皮书.docx

预览接入示例  <a href="https://api.hidocs.cn/api?furl=https://www.hidocs.cn/testfiles/hidocs产品白皮书.docx" target="_blank">点我预览</a>

Iframe接入方式说明

一、Iframe需要自适应文档高度模式  >>>   查看示例

此模式可以通过获取文档页面的高度来撑开页面的高度而不需要在iframe窗口里上下拖动查看

1、参数配置：预览地址里需要添加预览参数，word文档参数：pvt=5 ；ppt文档参数：pvt=2

2、iframe自适应文档高度：iframe里 添加 id=“iframe” 

3、在预览页面添加如下js

• 
  

• <script>
  window.addEventListener('message',(event)=>{
              let iframe=document.getElementById('iframe') 
              if(event.data.type=='docHeight'){
               let docWidth=event.data.docWidth
       let rate=1
       if(docWidth){
       rate+=(iframe.clientWidth-docWidth)/docWidth
       }
                  iframe.style.height=event.data.docHeight*rate+'px'
              }
          })
   </script>

  
  

• 
  

二、Iframe自适应屏幕高度模式 >>> 查看示例
此模式可以使得iframe铺满全屏，通过iframe滚动条上线滑动查看文档

1、参数配置：无需配置任何参数

2、iframe高度自适应：iframe里 添加 id=“iframe” 

3、在预览页面添加如下js

• 
  

  <script>
  // 获取浏览器当前高度
  window.addEventListener('load', function() {
  varbrowserHeight = window.innerHeight;
  // 将浏览器高度赋予iframe的高度
  document.getElementById('iframe').style.height = browserHeight - 40 + 'px';
  // 如果iframe上有工具栏，则如示例需要减去工具栏高度40px，反之测不要减高度
      });
  </script>

  
  

PPT iframe调用示例

<iframe src="width="100%" height="860px" id="iframe"></iframe>

特殊说明

如果接入网站采用https协议，同时通过iframe方式嵌入预览服务，则在拼装预览地址时，必须使用https协议（https://api.hidocs.cn)，否则预览服务无法调用

例如：<iframe src="https://api.hidocs.cn/api?furl=https://www.baidu.com/123456.docx" width="100%" height="1000px"></iframe>