Kunci API, skop dan mod ujian

4 min bacaan · Dikemas kini 2026-11-15

Jawapan ringkas

Dengan Pro dan Team, cipta kunci API di Papan pemuka > Domain & API. Setiap kunci mempunyai skop (Baca sahaja, Baca dan tulis atau Akses penuh) dan mod: kunci langsung (pf_live_) berfungsi sebenar, kunci ujian (pf_test_) tidak pernah menghantar e-mel dan pemindahannya tamat tempoh selepas 24 jam.

API Pandafile membolehkan aplikasi, skrip dan pelayan anda sendiri menghantar fail, mengumpul muat naik dan meminta tandatangan. Ia termasuk dalam Pro dan Team dan mengikut had yang sama seperti laman web. Semuanya bermula dengan kunci API.

Cipta kunci

  1. Log masuk dan buka Papan pemuka > Domain & API.
  2. Di bawah Kunci API, beri nama kepada kunci, contohnya Muat naik laman web.
  3. Pilih mod kunci, Langsung atau Ujian, dan akses kunci: Akses penuh, Baca dan tulis, atau Baca sahaja.
  4. Tekan Cipta kunci dan salin kunci itu dengan segera. Demi keselamatan anda, kami hanya menunjukkannya sekali.
  5. Hantar kunci dengan setiap permintaan dalam pengepala Authorization: Bearer diikuti kunci itu.

Anda boleh mempunyai sehingga 10 kunci aktif. Kunci langsung bermula dengan pf_live_ dan kunci ujian dengan pf_test_. Panduan pembangun ada di pandafile.co/developers dan rujukan API di pandafile.co/developers/api.

Skop: apa yang boleh dilakukan oleh kunci

  • Baca sahaja: permintaan GET sahaja. Kunci boleh mencari maklumat tetapi tidak mengubah apa-apa.
  • Baca dan tulis: semua dalam Baca sahaja, serta mencipta, mengubah dan memadam pemindahan, permintaan fail, permintaan tandatangan dan langganan webhook.
  • Akses penuh: semuanya, termasuk tetapan akaun seperti penjenamaan dan jemputan pasukan.

Mod ujian

  • Pemindahan yang dibuat dengan kunci pf_test_ ialah data ujian. Tiada sesiapa yang menerima e-mel, termasuk penerima yang anda tambah.
  • Pemindahan ujian sentiasa tamat tempoh 24 jam selepas dicipta dan tidak boleh dilanjutkan.
  • Ia tidak dikira dalam mana-mana had, storan atau penggunaan, dan tidak muncul dalam senarai pemindahan biasa anda.
  • Peristiwa webhook tentangnya mempunyai livemode ditetapkan kepada false, dan ia tidak pernah dihantar ke Slack, Microsoft Teams atau Discord.
  • Beberapa tindakan hanya berfungsi dengan kunci langsung. Dengan kunci ujian, API akan menjawab dengan ralat test_mode_unsupported.

Pastikan kunci selamat

  • Sesiapa yang mempunyai kunci boleh menghantar fail dari akaun anda. Simpan kunci pada pelayan anda, jangan sekali-kali dalam kod awam laman web atau aplikasi.
  • Batalkan kunci di Papan pemuka > Domain & API jika ia mungkin telah bocor. Aplikasi yang menggunakannya berhenti berfungsi serta-merta, dan langganan webhook yang dibuat dengannya, contohnya oleh Zapier atau Make, juga berhenti.
  • Setiap kunci mempunyai had kadarnya sendiri. Setiap respons menunjukkan kedudukan anda dalam pengepala RateLimit.
  • Dalam pasukan, kunci API adalah peribadi: setiap ahli mencipta kunci sendiri.
Sedia untuk menghantar?

Sehingga 50 GB percuma setiap pemindahan, tanpa perlu akaun.

Hantar fail