API-kulcsok, hozzáférési szintek és tesztmód
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
- Jelentkezz be, és nyisd meg az Irányítópult > Domain és API menüt.
- Az API-kulcsok résznél adj nevet a kulcsnak, például Weboldal-feltöltések.
- 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.
- 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.
- 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.