Chei API, drepturi de acces și modul test

4 min de citit · Actualizat pe 2026-11-15

Pe scurt

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

  1. Autentifică-te și deschide Panou de control > Domeniu și API.
  2. La Chei API, dă-i cheii un nume, de exemplu Încărcări de pe site.
  3. Alege modul cheii, Live sau Test, și accesul cheii: Acces complet, Citire și scriere sau Doar citire.
  4. Apasă Creează cheia și copiaz-o imediat. Pentru siguranța ta, o afișăm o singură dată.
  5. 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.
Gata de trimis?

Până la 50 GB gratuit per transfer, fără cont.

Trimite fișiere