API 密钥、权限范围和测试模式
简短回答
在 Pro 和 Team 中,于 控制台 > 域名与 API 创建 API 密钥。每个密钥都有权限范围(只读、读取和写入、完全访问)和模式:正式密钥(pf_live_)真实生效,测试密钥(pf_test_)从不给任何人发邮件,其传输 24 小时后过期。
借助 Pandafile API,你自己的应用、脚本和服务器可以发送文件、收集上传和发起签署请求。API 包含在 Pro 和 Team 中,遵循与网站相同的限制。一切从 API 密钥开始。
创建密钥
- 登录并打开 控制台 > 域名与 API。
- 在“API 密钥”下为密钥命名,例如“网站上传”。
- 选择密钥模式(正式或测试)和密钥权限(完全访问、读取和写入或只读)。
- 点击“创建密钥”,并立即复制密钥。出于安全考虑,我们只显示一次。
- 每个请求都在请求头中发送 Authorization: Bearer,后面加上密钥。
你最多可以拥有 10 个有效密钥。正式密钥以 pf_live_ 开头,测试密钥以 pf_test_ 开头。开发者指南位于 pandafile.co/developers,API 参考位于 pandafile.co/developers/api。
权限范围:密钥能做什么
- 只读:仅限 GET 请求。密钥可以查询信息,但不能更改任何内容。
- 读取和写入:包含只读的全部功能,另外可以创建、更改和删除传输、文件请求、签署请求和 Webhook 订阅。
- 完全访问:可以做所有事,包括品牌设置和团队邀请等账户设置。
测试模式
- 用 pf_test_ 密钥创建的传输是测试数据。不会给任何人发邮件,包括你添加的收件人。
- 测试传输总是在创建 24 小时后过期,且无法延长。
- 它们不计入任何限制、存储空间或用量,也不会出现在你的普通传输列表中。
- 与它们相关的 Webhook 事件中 livemode 为 false,并且绝不会发送到 Slack、Microsoft Teams 或 Discord。
- 少数操作只能用正式密钥执行。若用测试密钥调用,API 会返回错误 test_mode_unsupported。
保护好你的密钥
- 任何拿到密钥的人都能用你的账户发送文件。请把密钥保存在服务器上,绝不要放进网站或应用的公开代码中。
- 如果密钥可能已泄露,请在 控制台 > 域名与 API 中将其撤销。使用它的应用会立即停止工作,用它创建的 Webhook 订阅(例如 Zapier 或 Make 创建的)也会一并停止。
- 每个密钥都有自己的速率限制。每个响应的 RateLimit 请求头都会显示当前用量。
- 在团队中,API 密钥是个人的:每位成员各自创建自己的密钥。