Chei API, drepturi de acces și modul test
Pe Pro și Team, creezi chei API în Panou de control > Domeniu și API. Fiecare cheie are un nivel de acces (Doar citire, Citire și scriere sau Acces complet) și un mod: cheile live (pf_live_) funcționează pe bune, cheile de test (pf_test_) nu trimit niciodată e-mailuri, iar transferurile lor expiră după 24 de ore.
API-ul Pandafile le permite aplicațiilor, scripturilor și serverelor tale să trimită fișiere, să colecteze încărcări și să ceară semnături. Este inclus în Pro și Team și respectă aceleași limite ca site-ul. Totul începe cu o cheie API.
Creează o cheie
- Autentifică-te și deschide Panou de control > Domeniu și API.
- La Chei API, dă-i cheii un nume, de exemplu Încărcări de pe site.
- Alege modul cheii, Live sau Test, și accesul cheii: Acces complet, Citire și scriere sau Doar citire.
- Apasă Creează cheia și copiaz-o imediat. Pentru siguranța ta, o afișăm o singură dată.
- Trimite-o cu fiecare cerere în headerul Authorization: Bearer urmat de cheie.
Poți avea cel mult 10 chei active. Cheile live încep cu pf_live_, iar cele de test cu pf_test_. Ghidul pentru dezvoltatori e la pandafile.co/developers, iar referința API la pandafile.co/developers/api.
Drepturi de acces: ce poate face o cheie
- Doar citire: numai cereri GET. Cheia poate căuta informații, dar nu poate schimba nimic.
- Citire și scriere: tot ce permite Doar citire, plus crearea, modificarea și ștergerea transferurilor, a solicitărilor de fișiere, a cererilor de semnătură și a abonamentelor webhook.
- Acces complet: tot, inclusiv setările contului, cum ar fi brandingul și invitațiile în echipă.
Modul test
- Transferurile făcute cu o cheie pf_test_ sunt date de test. Nimeni nu primește vreodată e-mail, nici măcar destinatarii pe care îi adaugi.
- Transferurile de test expiră întotdeauna la 24 de ore după ce au fost create și nu pot fi prelungite.
- Nu se pun la nicio limită, la stocare sau la consum și nu apar în listele obișnuite de transferuri.
- Evenimentele webhook despre ele au livemode setat pe false și nu ajung niciodată în Slack, Microsoft Teams sau Discord.
- Câteva acțiuni funcționează doar cu o cheie live. Cu o cheie de test, API-ul răspunde atunci cu eroarea test_mode_unsupported.
Păstrează cheile în siguranță
- Oricine are o cheie poate trimite fișiere din contul tău. Ține cheile pe server, niciodată în codul public al unui site sau al unei aplicații.
- Revocă o cheie în Panou de control > Domeniu și API dacă e posibil să fi ajuns la altcineva. Aplicațiile care o folosesc nu mai funcționează imediat, iar abonamentele webhook create cu ea, de exemplu de Zapier sau Make, se opresc și ele.
- Fiecare cheie are propria limită de cereri. Fiecare răspuns îți arată unde te afli, în headerele RateLimit.
- Într-o echipă, cheile API sunt personale: fiecare membru își creează propriile chei.