Pandafile · 50 GB gratis ogni settimana
API per il trasferimento file per le tue app e i tuoi flussi di lavoro
Pandafile ha un'API REST per inviare file pesanti dal tuo codice, dai tuoi server e dai tuoi strumenti no-code. Crea un trasferimento, carica i file con upload ripristinabili, invia via email link personali ai destinatari e ricevi un webhook quando qualcuno scarica. L'API fa parte di Pro e Team, segue gli stessi limiti dell'app web ed è descritta in un documento OpenAPI 3.1 pubblico. Le chiavi di prova ti permettono di sviluppare ed eseguire test senza inviare email reali né usare il tuo spazio di archiviazione.
Un'API REST descritta in OpenAPI 3.1
Tutti gli endpoint si trovano sotto /api/v1 e usano JSON. Ti autentichi con una chiave API nell'header Authorization come token Bearer. Le chiavi si creano nella dashboard, vengono mostrate una sola volta e possono essere limitate a sola lettura, lettura e scrittura o accesso completo, così uno script di reportistica non ha mai il potere di eliminare trasferimenti. L'intera API è descritta in un documento OpenAPI 3.1 leggibile dalle macchine all'indirizzo /api/v1/openapi.json, che puoi caricare in Postman, usare per generare un client o passare a un assistente di programmazione con IA. La guida per sviluppatori su /developers spiega i concetti, e il riferimento API su /developers/api elenca ogni endpoint con esempi. Ogni risposta contiene un ID richiesta, i limiti di utilizzo sono indicati negli header RateLimit, gli elenchi usano la paginazione a cursore e gli errori condividono un unico formato JSON.
Upload ripristinabili con tus
File pesanti e reti instabili non vanno d'accordo con un'unica lunga richiesta HTTP. Per inviare file, crei prima un trasferimento con POST /api/v1/transfers, indicando i file, il titolo, il messaggio e, se vuoi, gli indirizzi email dei destinatari. Ogni file viene poi caricato con tus, il protocollo aperto per gli upload ripristinabili, così una connessione caduta o un server riavviato riprende dall'ultimo byte invece di ricominciare da capo. Esistono client tus pronti all'uso per JavaScript, Python, Go, Java, .NET, Swift e altri linguaggi. Quando tutti i file sono arrivati, chiami complete e il trasferimento diventa un normale link Pandafile, con pagina di download, link personali per i destinatari, promemoria e scadenza. Valgono gli stessi limiti del piano previsti nel browser: fino a 1000 GB per trasferimento e 1500 GB di spazio di archiviazione con Pro.
Invia file direttamente da un URL
A volte il file si trova già altrove: un allegato del CRM, l'output di una render farm o un export su un altro server. POST /api/v1/transfers/from-url accetta URL HTTPS e lascia che sia Pandafile a recuperare i file, poi crea e completa il trasferimento. La richiesta attende fino a 20 secondi. Le importazioni piccole tornano già completate, quelle più grandi rispondono subito con lo stato uploading mentre l'importazione prosegue in background. Puoi seguire l'avanzamento con GET /api/v1/transfers/{id}/import oppure aspettare semplicemente il webhook transfer.ready. È così che anche le integrazioni con Zapier e Make inviano file senza che il tuo flusso debba prima scaricarli.
Webhook e notifiche
Invece di interrogare continuamente l'API, iscriviti agli eventi. Pandafile può chiamare il tuo URL quando un trasferimento è pronto, scaricato o scaduto, quando un destinatario approva i file o chiede modifiche, quando qualcuno carica file in una delle tue richieste di file e quando una richiesta di firma viene completata. Ogni consegna è firmata con HMAC-SHA256 in un header Pandafile-Signature, così puoi verificare che provenga davvero da noi, e le consegne non riuscite vengono ritentate dopo 1 minuto, 5 minuti, 30 minuti, 2 ore e 12 ore. Gli eventi vengono anche conservati per 30 giorni e si possono leggere con GET /api/v1/events. Se non ti serve scrivere codice, gli stessi eventi possono pubblicare messaggi su Slack, Microsoft Teams o Discord.
Chiavi di prova, tentativi sicuri e cos'altro puoi automatizzare
Le chiavi API hanno due modalità. Le chiavi live iniziano con pf_live_ e quelle di prova con pf_test_. I trasferimenti creati con una chiave di prova non inviano mai email, non contano mai sul tuo spazio o sul tuo utilizzo, vengono conservati solo 24 ore e non compaiono nel normale elenco dei trasferimenti, così puoi eseguire test di integrazione sull'API reale senza effetti collaterali. Le richieste POST e PATCH accettano un header Idempotency-Key, quindi una richiesta ripetuta non crea mai un secondo trasferimento. Oltre ai trasferimenti, l'API copre destinatari e promemoria, cronologia dei download, statistiche del link e approvazioni, richieste di file, richieste di firma, personalizzazione del brand e inviti al team. L'API è inclusa in Pro, da $5,99 al mese o $49,99 all'anno, e in Team, da $14,99 al mese o $129,99 all'anno. In un team, ogni membro ha le proprie chiavi personali.
Guida per sviluppatori · Riferimento API · Documento OpenAPI 3.1
Domande
Pandafile ha un'API?
Sì. Pandafile ha un'API REST sotto /api/v1 per creare trasferimenti, caricare file, gestire destinatari, richieste di file e richieste di firma, e ricevere webhook. È inclusa nei piani Pro e Team.
Dove si trova la documentazione dell'API?
La guida per sviluppatori è su /developers e il riferimento API completo con esempi è su /developers/api. Il documento OpenAPI 3.1 leggibile dalle macchine è pubblico su /api/v1/openapi.json.
Gli upload possono riprendere se la connessione cade?
Sì. I file vengono caricati con il protocollo tus per gli upload ripristinabili, quindi un caricamento interrotto riprende da dove si era fermato invece di ricominciare da capo.
Posso fare test senza inviare email reali?
Sì. Usa una chiave di prova che inizia con pf_test_. I trasferimenti di prova non inviano mai email, non contano sul tuo spazio o sul tuo utilizzo e vengono eliminati dopo 24 ore.
Posso inviare un file che è già online?
Sì. POST /api/v1/transfers/from-url recupera i file da URL HTTPS e li trasforma in un trasferimento. Le importazioni più grandi proseguono in background, e il webhook transfer.ready ti avvisa quando il link è pronto.
Leggi la guida per sviluppatori
Popolari
- Ottieni l'approvazione dei clienti sui file
- Condivisione file per team
- Scopri chi ha scaricato i tuoi file
- Trasferimento file con crittografia end-to-end
- Trasferimento file per fotografi, in qualità piena
- Trasferimento file per videomaker e montatori
- Trasferimento file gratuito fino a 50 GB
- Inviare file pesanti gratis, senza complicazioni
- Inviare video pesanti in qualità originale
- Inviare un file da 1 GB gratis, in pochi secondi
- Inviare file pesanti da iPhone, senza app
- Pandafile o WeTransfer: un confronto onesto