Chiavi API, permessi e modalità test
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
- Accedi e apri Dashboard > Dominio e API.
- In Chiavi API dai un nome alla chiave, per esempio Caricamenti dal sito.
- Scegli la modalità della chiave, Live o Test, e l'accesso della chiave: Accesso completo, Lettura e scrittura o Sola lettura.
- Premi Crea chiave e copiala subito. Per la tua sicurezza la mostriamo una sola volta.
- 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.