Skip to content

个人文件下载

本示例以 Web 应用为基础,展示了基于金山文档开放平台,如何创建服务商、创建应用、应用授权以及通过 OpenApi 获取用户信息、文档列表,下载个人空间文件的全流程。

🚩 开发前准备

提示

  1. 完成开发者账号注册后,可在个人中心查看账号信息,此处的开发者账号就是 WPS 账号。
  2. 创建服务商后,可通过首页-开发者后台,查看服务商信息,以及添加或管理应用。
  3. 创建应用后,需要等待应用审核,通过后会生成 APPID 和 APPKEY。请妥善保管您的 APPID 和 APPKEY,由于应用 APPKEY 和获取到的 access_token 安全级别比较高,OpenApi 必须从服务器端调用。

🚩 场景分析

分析该案例场景,大致分为以下几个步骤:

  1. OAuth 授权,使用我们已注册应用的 APPID 和 APPKEY 获取授权
  2. 授权成功后,通过 redirect_uri 返回的 code 参数,请求接口换取 access_token 和 refresh_token。后续调用 OpenApi 接口时,使用 access_token 识别调用者身份
  3. 服务器端针对需求的 OpenApi,封装成为业务接口。(本示例中用到的接口:获取用户信息、 获取文档列表、下载文件)
  4. Web 应用或客户端请求包装好的接口,获取用户信息
  5. 获取个人文档列表
  6. 获取下载地址,保存文件到本地

🚩 接入流程

本示例的接入步骤如下:

  1. 业务前端(本示例为 demo.kdocs.cn),首先点击跳转授权按钮

跳转授权

  1. 跳转授权地址

授权页

  1. 授权成功后

授权成功


  1. 通过 code,调用 getAccessToken 接口

获取token


  1. 获取用户信息

用户信息


  1. 获取到列表

用户信息


  1. 点击下载文件

用户信息


所有流程已完毕。

🚩Demo 下载地址

示例代码:下载