Drive 共享链接 API 与 MCP 指南
通过 REST API 或 MCP 创建、列出和撤销 TrekMail Drive 公共共享链接，并设置到期日期、下载限制及审计日志。
文章详情
类型、难度、套餐及最近更新信息。
▼
文章详情
类型、难度、套餐及最近更新信息。
- 类型
- 参考资料
- 难度
- 中级
- 套餐
- Starter · Pro · Agency · + Drive Add-on
- 最近更新
- 2026年9月10日
使用共享链接可以将 Drive 文件发送到 TrekMail 账户之外，而无需发送大型电子邮件附件。API 和 MCP 工具可以创建链接、列出文件的链接，并在需要终止访问时撤销链接。
共享链接适合用于向客户交付成果、发送账单、视频文件、导出包，以及分享因过大或使用期过短而不适合作为电子邮件附件的任何文件。
所需权限范围
对于账户 Drive 文件，请使用 drive:account:share。对于邮箱 Drive 文件，请使用 drive:mailbox:share。读取权限范围也很有用，因为大多数工作流需要先找到文件再进行共享。
共享权限范围不允许上传、重命名、移动、移入回收站、恢复或彻底清除文件。如果代理的唯一任务是交付文件，请将这些权限与其他权限分开。
使用 REST 创建链接
curl -s -X POST "https://trekmail.net/api/v1/drive/files/{FILE_ID}/share-links" \
-H "Authorization: Bearer tm_live_your_token" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: share-{FILE_ID}-client-a" \
-d '{"expires_at":"2026-06-01T00:00:00Z","max_downloads":25}'
响应中包含公共 URL。原始共享令牌仅在创建时返回。如果令牌丢失，请撤销该链接并创建新链接。
使用 MCP 创建链接
drive_share_create(file_id=123, expires_at="2026-06-01T00:00:00Z", max_downloads=25)
要求代理在最终答复中返回 URL，并注明到期时间与下载次数上限。
列出和撤销链接
使用列表 endpoint 或 drive_share_list 查看文件的有效链接和历史链接。如果链接发送给了错误的人、合同不再有效或临时交付期已经结束，请撤销链接。
drive_share_revoke(link_id=456)
撤销会立即生效。如果需要恢复访问，请创建新链接。
推荐默认值
| 使用场景 | 到期时间 | 下载次数上限 |
|---|---|---|
| 供客户审核的文件 | 7-14 天 | 10-50 |
| 已签署的合同 | 30-90 天 | 5-20 |
| 公共活动素材 | 活动结束日期 | 可按需设置更高上限 |
| 临时内部交接 | 1-7 天 | 5-10 |
无限制链接很方便，但日后更难评估其使用情况。如果选择不设置到期时间，请在自己的系统中添加说明并解释原因。
安全行为
任何拥有 URL 的人都可以访问共享链接。它由无法猜测的令牌保护，而不是由 TrekMail 登录保护。除非你的组织接受这种模式，否则不要为需要指定收件人访问的文件发送公共链接。
下载页面不会泄露不必要的账户详细信息。已到期、已撤销或已用尽下载次数的链接会停止工作，且不会暴露文件的私密信息。
审计记录
共享链接的创建和撤销会连同 API 令牌身份一起记录。如果代理为客户创建链接，请定期检查审计日志，并在团队职责发生变化时轮换令牌。
相关文章
跳转到延续此工作流的邻近指南。