# 简介

本教程介绍如何使用开放平台云文档能力将本地 Word 文件导入到飞书云文档，并提取飞书云文档中过期的链接，将其修正为导入后的新链接地址。

## 流程概览

本教程提供的示例代码将按照以下流程调用飞书开放接口，最终实现链接的替换。

![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/449d37340de5130093217eccfc63a80f_W6dyQM5iKc.png?height=896&lazyload=true&maxWidth=750&width=918)

## 实现效果

按照本教程操作，最终可实现如下图的示意效果。

![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5b82c8ab82c64d958a95cea299ddad00~tplv-goo7wpa0wc-image.image?height=821&lazyload=true&maxWidth=550&width=1280)

## 使用到的 API 列表

本教程调用了鉴权与云文档业务域的以下接口：

### 鉴权

**[方法 (API)](https://open.feishu.cn/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求 | **[访问凭证](https://open.feishu.cn/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）**
---|---|---
[获取 tenant_access_token](https://open.feishu.cn/document/ukTMukTMukTM/ukDNz4SO0MjL5QzM/auth-v3/auth/tenant_access_token_internal)<br>`GET` /open-apis/auth/v3/tenant_access_token/internal<br>> 通过此接口获取 tenant_access_token

### 云文档

**[方法 (API)](https://open.feishu.cn/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求 | **[访问凭证](https://open.feishu.cn/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）**
---|---|---
[获取空间根目录](https://open.feishu.cn/document/ukTMukTMukTM/ugTNzUjL4UzM14CO1MTN/get-root-folder-meta)<br>`GET` /open-apis/drive/explorer/v2/root_folder/meta<br>> 获取云空间的根目录 | 查看、评论、编辑和管理云空间中所有文件(drive:drive) | `tenant_access_token`<br>`user_access_token`
[上传文件](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/upload_all)<br>`POST` /open-apis/drive/v1/files/upload_all<br>> 向云空间指定目录下上传一个小文件 | 查看、评论、编辑和管理云空间中所有文件(drive:drive) | `tenant_access_token`<br>`user_access_token`
[创建导入任务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/import_task/create)<br>`POST` /open-apis/drive/v1/import_tasks<br>> 创建导入任务 | 查看、评论、编辑和管理云空间中所有文件(drive:drive) | `tenant_access_token`<br>`user_access_token`
[查询导入任务结果](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/import_task/get)<br>`GET` /open-apis/drive/v1/import_tasks/:ticket<br>> 根据创建导入任务返回的 ticket 查询导入结果 | 查看、评论、编辑和管理云空间中所有文件(drive:drive) | `tenant_access_token`<br>`user_access_token`
[更新云文档权限设置](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/permission-public/patch)<br>`PATCH` /open-apis/drive/v1/permissions/:token/public<br>> 该接口用于根据 filetoken 更新云文档的权限设置 | 查看、评论、编辑和管理云空间中所有文件(drive:drive) | `tenant_access_token`<br>`user_access_token`
[获取文档所有块](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document-block/list)<br>`GET` /open-apis/docx/v1/documents/:document_id/blocks<br>> 获取文档所有块的富文本内容并分页返回 | 创建及编辑 DocX 文档(docx:document) | `tenant_access_token`<br>`user_access_token`
[更新块](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document-block/patch)<br>`PATCH` /open-apis/docx/v1/documents/:document_id/blocks/:block_id<br>> 更新指定的块 | 创建及编辑 DocX 文档(docx:document) | `tenant_access_token`<br>`user_access_token`

