Khóa API, phạm vi quyền và chế độ thử nghiệm

Đọc 4 phút · Cập nhật 2026-11-15

Trả lời ngắn

Trên Pro và Team, tạo khóa API trong Bảng điều khiển > Tên miền & API. Mỗi khóa có phạm vi quyền (Chỉ đọc, Đọc và ghi hoặc Toàn quyền) và chế độ: khóa thật (pf_live_) hoạt động thật, khóa thử nghiệm (pf_test_) không bao giờ gửi email cho ai và lượt chuyển của nó hết hạn sau 24 giờ.

Pandafile API cho phép ứng dụng, script và máy chủ của bạn gửi file, nhận file tải lên và yêu cầu ký. API có trong Pro và Team và áp dụng cùng giới hạn như trang web. Mọi thứ bắt đầu từ một khóa API.

Tạo khóa

  1. Đăng nhập và mở Bảng điều khiển > Tên miền & API.
  2. Trong Khóa API, đặt tên cho khóa, ví dụ Tải lên từ website.
  3. Chọn chế độ khóa, Thật hoặc Thử nghiệm, và quyền của khóa: Toàn quyền, Đọc và ghi, hoặc Chỉ đọc.
  4. Bấm Tạo khóa và sao chép khóa ngay. Vì lý do bảo mật, chúng tôi chỉ hiện khóa một lần.
  5. Gửi khóa kèm mọi yêu cầu trong header Authorization: Bearer, theo sau là khóa.

Bạn có thể có tối đa 10 khóa đang hoạt động. Khóa thật bắt đầu bằng pf_live_ và khóa thử nghiệm bằng pf_test_. Hướng dẫn cho lập trình viên ở pandafile.co/developers và tài liệu tham chiếu API ở pandafile.co/developers/api.

Phạm vi quyền: khóa được làm gì

  • Chỉ đọc: chỉ các yêu cầu GET. Khóa có thể tra cứu nhưng không thay đổi được gì.
  • Đọc và ghi: mọi thứ trong Chỉ đọc, cộng thêm tạo, sửa và xóa lượt chuyển, yêu cầu gửi file, yêu cầu ký và đăng ký webhook.
  • Toàn quyền: mọi thứ, gồm cả cài đặt tài khoản như thương hiệu và lời mời vào nhóm.

Chế độ thử nghiệm

  • Lượt chuyển tạo bằng khóa pf_test_ là dữ liệu thử nghiệm. Không ai nhận được email, kể cả người nhận bạn thêm vào.
  • Lượt chuyển thử nghiệm luôn hết hạn 24 giờ sau khi tạo và không thể gia hạn.
  • Chúng không tính vào bất kỳ giới hạn, dung lượng lưu trữ hay mức sử dụng nào, và không hiện trong danh sách lượt chuyển thông thường.
  • Sự kiện webhook về chúng có livemode là false, và không bao giờ được gửi tới Slack, Microsoft Teams hay Discord.
  • Một vài thao tác chỉ dùng được với khóa thật. Khi dùng khóa thử nghiệm, API trả về lỗi test_mode_unsupported.

Giữ khóa an toàn

  • Ai có khóa cũng có thể gửi file từ tài khoản của bạn. Hãy giữ khóa trên máy chủ, không bao giờ đặt trong mã công khai của website hay ứng dụng.
  • Thu hồi khóa trong Bảng điều khiển > Tên miền & API nếu nó có thể đã bị lộ. Ứng dụng dùng khóa đó ngừng hoạt động ngay, và các đăng ký webhook tạo bằng khóa đó, ví dụ bởi Zapier hoặc Make, cũng dừng theo.
  • Mỗi khóa có giới hạn tần suất riêng. Mọi phản hồi đều cho biết tình trạng của bạn trong các header RateLimit.
  • Trong nhóm, khóa API là của riêng từng người: mỗi thành viên tự tạo khóa của mình.
Sẵn sàng gửi chưa?

Miễn phí đến 50 GB mỗi lượt chuyển, không cần tài khoản.

Gửi tệp