订阅云文档事件

POST

/drive/v1/files/{file_token}/subscribe

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

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

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Query 参数

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST '/drive/v1/files//subscribe?file_type' \
--header 'Authorization: Bearer <token>'

响应示例

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

修改于 2025-10-21 03:50:13