使用指南

如何通过文件上传 API 生成临时分享链接?

登录后创建 API Key,使用 Bearer Header 调用飞传上传接口,即可取得临时文件的 share_url。

创建 API Key

先创建自己的 API Key

API Key 仅供登录账户下的脚本、自动化任务或 Agent 调用飞传 API。不要把 Key 放在 URL、聊天记录或交付给接收方;接收方只需要分享链接。

调用文件上传接口

使用 multipart/form-data 上传文件。飞传会返回 Transfer 标识、取件码和可交付的 share_url。

  1. 创建 API Key在个人中心的 API Keys 页面创建并保存调用凭证。
  2. 发送上传请求在 Authorization Bearer Header 中携带 API Key。
  3. 读取 share_url从成功响应中取得分享链接和过期时间。
  4. 交付链接将 share_url 发送给人或另一个 Agent。

curl 示例

curl -X POST https://f.devtool.uk/api/v1/transfers -H "Authorization: Bearer fp_live_xxxxxxxxx" -F "[email protected]"

与网页上传使用同一套规则

API 上传和网页上传共用账户额度、文件限制、存储、分享和自动清理规则。对于较大文件,可使用文档中提供的分片上传流程。

常见问题

API 返回什么?

成功后会返回 Transfer 标识、pickup_code、share_url、到期时间和文件摘要。

能否用 API Key 访问其他账户的私有传输?

不能。API Key 只能操作所属账户的 Transfer。

在哪里看完整接口文档?

可访问飞传开发者中心或 OpenAPI 文档查看完整参数、响应和分片上传说明。

相关指南