Mga API key, scope at test mode

4 min basahin · Na-update 2026-11-15

Maikling sagot

Sa Pro at Team, gumawa ng mga API key sa Dashboard > Domain at API. May scope ang bawat key (Basa lang, Basa at sulat o Buong access) at mode: totoong gumagana ang live key (pf_live_), habang hindi kailanman nag-e-email ang test key (pf_test_) at nag-e-expire ang mga transfer nito pagkalipas ng 24 na oras.

Sa Pandafile API, makakapagpadala ng file, makakaipon ng upload at makakahiling ng pirma ang sarili mong mga app, script at server. Kasama ito sa Pro at Team at sumusunod sa parehong limitasyon gaya ng website. Nagsisimula ang lahat sa isang API key.

Gumawa ng key

  1. Mag-sign in at buksan ang Dashboard > Domain at API.
  2. Sa ilalim ng Mga API key, bigyan ng pangalan ang key, halimbawa Mga upload sa website.
  3. Piliin ang mode ng key, Live o Test, at ang access ng key: Buong access, Basa at sulat, o Basa lang.
  4. Pindutin ang Gumawa ng key at kopyahin agad ang key. Para sa seguridad mo, isang beses lang namin itong ipinapakita.
  5. Ipadala ito sa bawat request sa header na Authorization: Bearer na sinusundan ng key.

Puwede kang magkaroon ng hanggang 10 aktibong key. Nagsisimula sa pf_live_ ang mga live key at sa pf_test_ ang mga test key. Nasa pandafile.co/developers ang developer guide at nasa pandafile.co/developers/api ang API reference.

Mga scope: ano ang puwedeng gawin ng key

  • Basa lang: mga GET request lang. Makakatingin ang key pero wala itong mababago.
  • Basa at sulat: lahat ng nasa Basa lang, dagdag ang paggawa, pagbago at pagbura ng mga transfer, file request, signature request at webhook subscription.
  • Buong access: lahat, kasama ang mga setting ng account gaya ng branding at mga team invite.

Test mode

  • Test data ang mga transfer na ginawa gamit ang pf_test_ key. Walang kailanmang ie-email, kahit ang mga recipient na idinagdag mo.
  • Laging nag-e-expire ang mga test transfer 24 na oras matapos gawin at hindi puwedeng pahabain.
  • Hindi sila binibilang sa anumang limitasyon, storage o paggamit, at hindi sila lumalabas sa karaniwang listahan ng mga transfer mo.
  • Naka-false ang livemode ng mga webhook event tungkol sa kanila, at hindi kailanman napupunta ang mga ito sa Slack, Microsoft Teams o Discord.
  • May ilang aksyon na gumagana lang gamit ang live key. Kapag test key ang gamit, sasagot ang API ng error na test_mode_unsupported.

Panatilihing ligtas ang mga key

  • Makakapagpadala ng file mula sa account mo ang sinumang may key. Itago ang mga key sa server mo, huwag kailanman sa pampublikong code ng website o app.
  • Bawiin ang key sa Dashboard > Domain at API kung posibleng na-leak ito. Agad na hihinto ang mga app na gumagamit nito, at hihinto rin ang mga webhook subscription na ginawa gamit ito, halimbawa ng Zapier o Make.
  • May sariling rate limit ang bawat key. Ipinapakita ng bawat response ang lagay mo sa mga RateLimit header.
  • Sa isang team, personal ang mga API key: gumagawa ng sarili niyang key ang bawat member.
Handa nang magpadala?

Hanggang 50 GB nang libre bawat transfer, walang kailangang account.

Magpadala ng mga file