订阅云文档事件

POST

https://open.feishu.cn/open-apis/drive/v1/files/{file_token}/subscribe

该接口仅支持文档拥有者订阅自己文档的通知事件，可订阅的文档类型为旧版文档、新版文档、电子表格和多维表格。在调用该接口之前请确保正确配置事件回调网址和订阅事件类型，事件类型参考事件列表。

错误码

HTTP状态码	错误码	描述	排查建议
500	1069601	fail	重试，若稳定失败请联系相关业务方 oncall 人员
400	1069602	param error	检查参数有效性
403	1069603	forbidden	检查用户是否有文件对应的阅读权限
400	1069604	document not found	检查文件是否存在

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.feishu.cn/open-apis/drive/v1/files//subscribe?file_type' \
--header 'Authorization;'

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {}
}

请求参数

Path 参数

file_token

string

必需

文档token 示例值："doccnxxxxxxxxxxxxxxxxxxxxxx"

Query 参数

file_type

string

必需

文档类型示例值："doc" 可选值有： doc：文档 docx：新版文档 sheet：表格 bitable：多维表格

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

修改于 2023-01-13 06:06:27

文件彻底删除

文档搜素

订阅云文档事件

错误码#

请求参数

返回响应

错误码