Chiavi API, permessi e modalità test

4 min di lettura · Aggiornato il 2026-11-15

Risposta breve

Con Pro e Team crei chiavi API in Dashboard > Dominio e API. Ogni chiave ha un permesso (Sola lettura, Lettura e scrittura o Accesso completo) e una modalità: le chiavi live (pf_live_) agiscono davvero, quelle di test (pf_test_) non inviano mai email e i loro trasferimenti scadono dopo 24 ore.

L'API di Pandafile permette alle tue app, ai tuoi script e ai tuoi server di inviare file, raccogliere caricamenti e richiedere firme. È inclusa in Pro e Team e segue gli stessi limiti del sito. Tutto inizia con una chiave API.

Crea una chiave

  1. Accedi e apri Dashboard > Dominio e API.
  2. In Chiavi API dai un nome alla chiave, per esempio Caricamenti dal sito.
  3. Scegli la modalità della chiave, Live o Test, e l'accesso della chiave: Accesso completo, Lettura e scrittura o Sola lettura.
  4. Premi Crea chiave e copiala subito. Per la tua sicurezza la mostriamo una sola volta.
  5. Inviala con ogni richiesta nell'header Authorization: Bearer seguito dalla chiave.

Puoi avere fino a 10 chiavi attive. Le chiavi live iniziano con pf_live_ e quelle di test con pf_test_. La guida per sviluppatori è su pandafile.co/developers e il riferimento dell'API su pandafile.co/developers/api.

Permessi: cosa può fare una chiave

  • Sola lettura: solo richieste GET. La chiave può consultare i dati ma non modificare nulla.
  • Lettura e scrittura: tutto ciò che permette Sola lettura, più creare, modificare ed eliminare trasferimenti, richieste di file, richieste di firma e iscrizioni webhook.
  • Accesso completo: tutto, comprese le impostazioni dell'account come il marchio e gli inviti al team.

Modalità test

  • I trasferimenti creati con una chiave pf_test_ sono dati di prova. Non viene mai inviata nessuna email, nemmeno ai destinatari che aggiungi.
  • I trasferimenti di prova scadono sempre 24 ore dopo la creazione e non si possono estendere.
  • Non contano per nessun limite, spazio o utilizzo, e non compaiono nei tuoi normali elenchi di trasferimenti.
  • Gli eventi webhook che li riguardano hanno livemode impostato su false e non vanno mai a Slack, Microsoft Teams o Discord.
  • Alcune azioni funzionano solo con una chiave live. Con una chiave di test l'API risponde con l'errore test_mode_unsupported.

Proteggi le tue chiavi

  • Chiunque abbia una chiave può inviare file dal tuo account. Tieni le chiavi sul tuo server, mai nel codice pubblico di un sito o di un'app.
  • Revoca una chiave in Dashboard > Dominio e API se potrebbe essere trapelata. Le app che la usano smettono subito di funzionare, e lo stesso vale per le iscrizioni webhook create con quella chiave, per esempio da Zapier o Make.
  • Ogni chiave ha il suo limite di richieste. Ogni risposta ti dice a che punto sei negli header RateLimit.
  • In un team le chiavi API sono personali: ogni membro crea le proprie.
Tutto pronto per inviare?

Fino a 50 GB gratis per trasferimento, senza account.

Invia file