API-kulcsok, hozzáférési szintek és tesztmód

4 perc olvasás · Frissítve: 2026-11-15

Röviden

Pro és Team csomagban az Irányítópult > Domain és API menüben hozhatsz létre API-kulcsokat. Minden kulcsnak van hozzáférési szintje (Csak olvasás, Olvasás és írás vagy Teljes hozzáférés) és módja: az éles kulcsok (pf_live_) élesben működnek, a tesztkulcsok (pf_test_) soha nem küldenek e-mailt, és a küldéseik 24 óra után lejárnak.

A Pandafile API-val a saját alkalmazásaid, szkriptjeid és szervereid fájlokat küldhetnek, feltöltéseket gyűjthetnek és aláírást kérhetnek. A Pro és a Team csomag része, és ugyanazok a korlátok vonatkoznak rá, mint a weboldalra. Minden egy API-kulccsal kezdődik.

Kulcs létrehozása

  1. Jelentkezz be, és nyisd meg az Irányítópult > Domain és API menüt.
  2. Az API-kulcsok résznél adj nevet a kulcsnak, például Weboldal-feltöltések.
  3. Válaszd ki a kulcs módját (Éles vagy Teszt) és a kulcs hozzáférését: Teljes hozzáférés, Olvasás és írás vagy Csak olvasás.
  4. Nyomd meg a Kulcs létrehozása gombot, és rögtön másold ki a kulcsot. A biztonságod érdekében csak egyszer mutatjuk meg.
  5. Minden kérésnél küldd el az Authorization: Bearer fejlécben, utána a kulccsal.

Legfeljebb 10 aktív kulcsod lehet. Az éles kulcsok pf_live_, a tesztkulcsok pf_test_ előtaggal kezdődnek. A fejlesztői útmutató a pandafile.co/developers, az API-referencia a pandafile.co/developers/api címen található.

Hozzáférési szintek: mit tehet egy kulcs?

  • Csak olvasás: kizárólag GET-kérések. A kulcs adatokat kérdezhet le, de semmit sem módosíthat.
  • Olvasás és írás: minden, amit a Csak olvasás tud, továbbá küldések, fájlkérések, aláírási kérések és webhook-feliratkozások létrehozása, módosítása és törlése.
  • Teljes hozzáférés: minden, a fiókbeállításokat is beleértve, például az arculatot és a csapatmeghívókat.

Tesztmód

  • A pf_test_ kulccsal készült küldések tesztadatok. Soha senki nem kap e-mailt, még a hozzáadott címzettek sem.
  • A tesztküldések mindig 24 órával a létrehozásuk után lejárnak, és nem hosszabbíthatók meg.
  • Nem számítanak bele semmilyen korlátba, a tárhelybe vagy a felhasználásba, és nem jelennek meg a szokásos küldéslistáidban.
  • A róluk szóló webhook-eseményekben a livemode értéke false, és soha nem kerülnek Slackbe, Microsoft Teamsbe vagy Discordra.
  • Néhány művelet csak éles kulccsal működik. Tesztkulccsal ilyenkor az API test_mode_unsupported hibával válaszol.

Tartsd biztonságban a kulcsokat

  • Aki birtokolja a kulcsot, fájlokat küldhet a fiókodból. A kulcsokat a szervereden tartsd, soha ne egy weboldal vagy alkalmazás nyilvános kódjában.
  • Ha egy kulcs illetéktelen kezekbe kerülhetett, vond vissza az Irányítópult > Domain és API menüben. Az azt használó alkalmazások azonnal leállnak, és a vele létrehozott webhook-feliratkozások, például a Zapier vagy a Make feliratkozásai, szintén megszűnnek.
  • Minden kulcsnak saját kéréskorlátja van. Minden válasz RateLimit fejlécei megmutatják, hol tartasz.
  • Egy csapatban az API-kulcsok személyesek: minden tag a sajátját hozza létre.
Kész vagy a küldésre?

Küldésenként akár 50 GB ingyen, fiók nélkül.

Fájlok küldése