Pandafile · 每周免费 50 GB

为你的应用和工作流打造的文件传输 API

Pandafile 提供 REST API,让你从自己的代码、服务器和无代码工具中发送大文件。创建传输,用断点续传上传文件,通过邮件给收件人发送专属链接,有人下载时通过 Webhook 收到通知。API 包含在 Pro 和 Team 中,与网页版遵循相同的限制,并有公开的 OpenAPI 3.1 文档描述。使用测试密钥,你可以在不发送真实邮件、不占用存储空间的情况下开发和测试。

阅读开发者指南

以 OpenAPI 3.1 描述的 REST API

所有端点都位于 /api/v1 之下,使用 JSON 通信。认证方式是在 Authorization 请求头中以 Bearer 令牌的形式携带 API 密钥。密钥在控制台中创建,只显示一次,可以限定为只读、读写或完全访问,这样报表脚本就永远不会拥有删除传输的权限。整个 API 都在 /api/v1/openapi.json 这份机器可读的 OpenAPI 3.1 文档中描述,你可以把它导入 Postman、据此生成客户端,或交给 AI 编程助手。/developers 的开发者指南讲解核心概念,/developers/api 的 API 参考则列出所有端点并附有示例。每个响应都带有请求 ID,速率限制通过 RateLimit 请求头告知,列表采用游标分页,错误统一使用同一种 JSON 格式。

基于 tus 的断点续传

大文件加上不稳定的网络,很难靠一个漫长的 HTTP 请求搞定。发送文件时,先用 POST /api/v1/transfers 创建传输,列出文件、标题、留言,以及(如需要)收件人的邮箱地址。然后每个文件都通过 tus 上传——这是一个用于断点续传的开放协议,即使连接中断或服务器重启,也能从最后一个字节继续,而不必从头开始。JavaScript、Python、Go、Java、.NET、Swift 等语言都有现成的 tus 客户端。所有文件上传完毕后调用 complete,这次传输就会变成一个普通的 Pandafile 链接,带有下载页面、收件人专属链接、提醒和有效期。套餐限制与浏览器中相同:Pro 单次传输最高 1000 GB,存储空间 1500 GB。

直接从 URL 发送文件

有时文件已经在别处了:CRM 里的附件、渲染农场的输出,或另一台服务器上的导出文件。POST /api/v1/transfers/from-url 接收 HTTPS URL,由 Pandafile 替你抓取文件,然后创建并完成传输。请求最多等待 20 秒。小型导入会直接返回已完成的结果,大型导入会立即返回 uploading 状态,并在后台继续导入。你可以用 GET /api/v1/transfers/{id}/import 跟踪进度,也可以直接等待 transfer.ready Webhook。Zapier 和 Make 集成也是这样发送文件的,你的工作流无需先把文件下载下来。

Webhook 与通知

不必轮询,订阅事件即可。当传输就绪、被下载或到期时,当收件人批准文件或要求修改时,当有人向你的文件请求上传文件时,以及当签署请求完成时,Pandafile 都可以调用你的 URL。每次投递都在 Pandafile-Signature 请求头中带有 HMAC-SHA256 签名,方便你确认它确实来自我们;投递失败会在 1 分钟、5 分钟、30 分钟、2 小时和 12 小时后重试。事件还会保留 30 天,可通过 GET /api/v1/events 读取。如果完全不想写代码,同样的事件也可以作为消息发送到 Slack、Microsoft Teams 或 Discord。

测试密钥、安全重试,以及更多可自动化的功能

API 密钥分为两种模式:正式密钥以 pf_live_ 开头,测试密钥以 pf_test_ 开头。用测试密钥创建的传输从不发送邮件,不计入你的存储空间或用量,只保留 24 小时,也不会出现在你平常的传输列表中,因此你可以针对真实的 API 运行集成测试,而不会产生副作用。POST 和 PATCH 请求支持 Idempotency-Key 请求头,重试请求也绝不会创建第二个传输。除了传输,API 还涵盖收件人和提醒、下载记录、链接统计和审批、文件请求、签署请求、品牌设置以及团队邀请。API 包含在 Pro(每月 $5.99 或每年 $49.99 起)和 Team(每月 $14.99 或每年 $129.99 起)中。在团队中,每位成员都有自己的个人密钥。

常见问题

Pandafile 有 API 吗?

有。Pandafile 在 /api/v1 下提供 REST API,可用于创建传输、上传文件、管理收件人、文件请求和签署请求,以及接收 Webhook。Pro 和 Team 套餐均包含 API。

API 文档在哪里?

开发者指南位于 /developers,带示例的完整 API 参考位于 /developers/api。机器可读的 OpenAPI 3.1 文档公开在 /api/v1/openapi.json。

连接断开后,上传能继续吗?

能。文件通过用于断点续传的 tus 协议上传,中断的上传会从停下的地方继续,而不必从头再来。

可以在不发送真实邮件的情况下测试吗?

可以。使用以 pf_test_ 开头的测试密钥。测试传输从不发送邮件,不计入你的存储空间或用量,并会在 24 小时后删除。

可以发送已经在网上的文件吗?

可以。POST /api/v1/transfers/from-url 会从 HTTPS URL 抓取文件并生成一个传输。较大的导入会在后台继续,链接就绪时 transfer.ready Webhook 会通知你。

阅读开发者指南

热门