Kunci API, cakupan, dan mode uji

Baca 4 mnt · Diperbarui 2026-11-15

Jawaban singkat

Di Pro dan Team, buat kunci API di Dasbor > Domain & API. Setiap kunci punya cakupan (Hanya baca, Baca dan tulis, atau Akses penuh) dan mode: kunci live (pf_live_) bekerja sungguhan, kunci uji (pf_test_) tidak pernah mengirim email dan transfernya kedaluwarsa setelah 24 jam.

API Pandafile memungkinkan aplikasi, skrip, dan server Anda sendiri mengirim file, mengumpulkan unggahan, dan meminta tanda tangan. API sudah termasuk dalam Pro dan Team dan mengikuti batas yang sama seperti situs web. Semuanya dimulai dengan kunci API.

Buat kunci

  1. Masuk dan buka Dasbor > Domain & API.
  2. Di Kunci API, beri nama kunci, misalnya Unggahan situs web.
  3. Pilih mode kunci, Live atau Uji, dan akses kunci: Akses penuh, Baca dan tulis, atau Hanya baca.
  4. Tekan Buat kunci dan langsung salin kuncinya. Demi keamanan Anda, kami hanya menampilkannya sekali.
  5. Kirim kunci di setiap permintaan dalam header Authorization: Bearer diikuti kuncinya.

Anda bisa memiliki hingga 10 kunci aktif. Kunci live diawali pf_live_ dan kunci uji diawali pf_test_. Panduan developer ada di pandafile.co/developers dan referensi API di pandafile.co/developers/api.

Cakupan: apa yang boleh dilakukan kunci

  • Hanya baca: hanya permintaan GET. Kunci bisa mencari informasi tetapi tidak mengubah apa pun.
  • Baca dan tulis: semua yang ada di Hanya baca, ditambah membuat, mengubah, dan menghapus transfer, permintaan file, permintaan tanda tangan, dan langganan webhook.
  • Akses penuh: semuanya, termasuk pengaturan akun seperti branding dan undangan tim.

Mode uji

  • Transfer yang dibuat dengan kunci pf_test_ adalah data uji. Tidak ada yang pernah dikirimi email, termasuk penerima yang Anda tambahkan.
  • Transfer uji selalu kedaluwarsa 24 jam setelah dibuat dan tidak bisa diperpanjang.
  • Transfer ini tidak dihitung ke batas, penyimpanan, atau pemakaian apa pun, dan tidak muncul di daftar transfer biasa Anda.
  • Peristiwa webhook tentang transfer ini memiliki livemode bernilai false, dan tidak pernah dikirim ke Slack, Microsoft Teams, atau Discord.
  • Beberapa tindakan hanya berfungsi dengan kunci live. Dengan kunci uji, API lalu menjawab dengan error test_mode_unsupported.

Jaga keamanan kunci

  • Siapa pun yang punya kunci bisa mengirim file dari akun Anda. Simpan kunci di server Anda, jangan pernah di kode publik situs web atau aplikasi.
  • Cabut kunci di Dasbor > Domain & API jika mungkin bocor. Aplikasi yang memakainya langsung berhenti bekerja, dan langganan webhook yang dibuat dengannya, misalnya oleh Zapier atau Make, juga berhenti.
  • Setiap kunci punya batas lajunya sendiri. Setiap respons menunjukkan posisi Anda di header RateLimit.
  • Dalam tim, kunci API bersifat pribadi: setiap anggota membuat kuncinya sendiri.
Siap mengirim?

Gratis hingga 50 GB per transfer, tanpa akun.

Kirim file