# 取消云文档事件订阅 该接口用于取消订阅云文档的通知事件。了解事件订阅的配置流程和使用场景，参考[事件概述](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM)。了解云文档支持的事件类型，参考[事件列表](https://open.feishu.cn/document/ukTMukTMukTM/uYDNxYjL2QTM24iN0EjN/event-list)。 ## 注意事项 目前只支持取消订阅事件列表中所有文档事件，暂不支持指定取消的事件。 ## 前提条件 - 调用接口前，请确保应用或用户为文档所有者或文档管理者。 - 调用接口前，请确保正确配置订阅方式并添加了事件。详情参考[配置订阅方式](https://open.feishu.cn/document/ukTMukTMukTM/uYDNxYjL2QTM24iN0EjN/event-subscription-configure-/request-url-configuration-case)和[添加事件](https://open.feishu.cn/document/ukTMukTMukTM/uYDNxYjL2QTM24iN0EjN/event-subscription-configure-/subscription-event-case)。 ## 请求 基本 |   ---|--- HTTP URL | https://open.feishu.cn/open-apis/drive/v1/files/:file_token/delete_subscribe HTTP Method | DELETE 接口频率限制 | [10 次/分钟](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN) 支持的应用类型 | Custom App、Store App 权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用**
开启任一权限即可 | 查看、评论、编辑和管理文档(docs:doc)
订阅云文档事件(docs:event:subscribe)
查看、评论、编辑和管理云空间中所有文件(drive:drive)
查看、评论、编辑和管理电子表格(sheets:spreadsheet) ### 请求头 名称 | 类型 | 必填 | 描述 ---|---|---|--- Authorization | string | 是 | `tenant_access_token`
或
`user_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer u-7f1bcd13fc57d46bac21793a18e560"
[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use) ### 路径参数 名称 | 类型 | 描述 ---|---|--- file_token | string | 云文档的 token。了解如何获取各类云文档的token，参考[云空间常见问题](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/faq)。
**示例值**："doccnfYZzTlvXqZIGTdAHKabcef" ### 查询参数 名称 | 类型 | 必填 | 描述 ---|---|---|--- file_type | string | 是 | 云文档类型
**示例值**：docx
**可选值有**：
- doc：旧版文档。已不推荐使用
- docx：新版文档
- sheet：电子表格
- bitable：多维表格
- file：文件
- folder：文件夹
- slides：幻灯片 event_type | string | 否 | 事件类型，`file_type` 为 `folder`（文件夹）时必填 `file.created_in_folder_v1`
**示例值**：file.created_in_folder_v1 ## 响应 ### 响应体 名称 | 类型 | 描述 ---|---|--- code | int | 错误码，非 0 表示失败 msg | string | 错误描述 data | \- | \- ### 响应体示例 ```json { "code": 0, "msg": "success", "data": { } } ``` ### 错误码 HTTP状态码 | 错误码 | 描述 | 排查建议 ---|---|---|--- 500 | 1069601 | fail | 重试，若稳定失败请联系[技术支持](https://applink.feishu.cn/client/helpdesk) 400 | 1069602 | param error | 检查参数有效性 403 | 1069603 | forbidden | 无权限操作，可能是如下原因：
* 调用身份无文档管理权限
* 当前租户未开启文档访问记录功能
请参考以下方式为调用身份开通文档管理权限：
- 如果你使用的是 `tenant_access_token`，意味着当前应用没有云文档权限。你需通过云文档网页页面右上方 **「...」** -> **「...更多」** ->**「添加文档应用」** 入口为应用添加管理权限。
![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/22c027f63c540592d3ca8f41d48bb107_CSas7OYJBR.png?height=1994&maxWidth=550&width=3278)
**注意**：在 **添加文档应用** 前，你需确保目标应用至少开通了一个云文档或多维表格的 [API 权限](https://open.feishu.cn/document/ukTMukTMukTM/uYTM5UjL2ETO14iNxkTN/scope-list)。否则你将无法在文档应用窗口搜索到目标应用。
![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/9f3353931fafeea16a39f0eb887db175_0tjzC9P3zU.png?maxWidth=550)
- 如果你使用的是 `user_access_token`，意味着当前用户没有云文档权限。你需通过云文档网页页面右上方 **分享** 入口为当前用户添加管理权限。
![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/3e052d3bac56f9441296ae22e2969d63_a2DEYrJup8.png?height=278&maxWidth=550&width=1383)
了解具体操作步骤或其它添加权限方式，参考[云文档常见问题 3](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN#16c6475a)。 400 | 1069604 | document not found | 检查文件是否存在 400 | 1069605 | Unsubscribe | 没有订阅文档 400 | 1064230 | locked for data migration | 数据迁移中，暂时无法上传。