96doc文档预览服务
    • 96DOC 文件在线预览服务与接入说明
    • 生成预览链接
      POST
    • 清除缓存/查询有效期
      POST
    • 上传本地文件
      POST

      清除缓存/查询有效期

      POST
      /api/cache
      action=clear 删除该完整原地址的全部转换缓存版本及关联 ZIP 子任务,但不删除上传源文件/分享规则,src 链接再访问可重建,旧 id 缓存地址失效。处理中清除返回 409。action=status 查询缓存;access 可选,查询指定分享规则请传 previewURL 的 access。不传时 permanent=true/expired=false 仅表示没有指定规则。已清理或不存在的 access 返回 404。此接口限制浏览器同源,跨域业务请由后端调用。

      JSON Body 参数说明#

      参数类型说明
      urlstring创建时的完整原始地址,包括签名参数;不是 /view 链接
      actionstringclear 清除缓存;status 查询有效期
      accessstring可选:previewURL 中的 access,用于查询该分享规则有效期。不能用任务 id 代替
      keystring可选:API 服务密钥

      请求参数

      Header 参数

      Body 参数application/json必填

      示例
      {
          "url": "http://www.96doc.com/demo/sample-v2.docx",
          "action": "status",
          "access": "{{access}}"
      }

      请求示例代码

      Shell
      JavaScript
      Java
      Swift
      Go
      PHP
      Python
      HTTP
      C
      C#
      Objective-C
      Ruby
      OCaml
      Dart
      R
      请求示例请求示例
      Shell
      JavaScript
      Java
      Swift
      cURL
      curl --location 'http://47.114.97.73:8088/api/cache' \
      --header 'X-Preview-Key: {{key}}' \
      --header 'Content-Type: application/json' \
      --data '{
          "url": "http://www.96doc.com/demo/sample-v2.docx",
          "action": "status",
          "access": "{{access}}"
      }'

      返回响应

      🟢200成功
      application/json
      清除缓存 / 查询有效期
      Bodyapplication/json

      示例
      {
          "action": "clear",
          "count": 0,
          "permanent": true,
          "expired": true,
          "linkExpiresAt": "2019-08-24T14:15:22.123Z",
          "cacheExpiresAt": "2019-08-24T14:15:22.123Z",
          "cacheTTLHours": 0
      }
      🟠400
      🟠401
      🟠403
      🟠404
      🟠405
      🟠409
      🟠413
      🟠429
      🔴500
      修改于 2026-10-12 13:24:46
      上一页
      生成预览链接
      下一页
      上传本地文件
      Built with