Pandafile · 50 GB δωρεάν κάθε εβδομάδα
API μεταφοράς αρχείων για τις εφαρμογές και τις ροές εργασίας σας
Το Pandafile διαθέτει REST API για αποστολή μεγάλων αρχείων από τον δικό σας κώδικα, τους servers σας και εργαλεία no-code. Δημιουργήστε μια μεταφορά, ανεβάστε αρχεία με συνεχιζόμενα ανεβάσματα, στείλτε προσωπικούς συνδέσμους στους παραλήπτες με email και λάβετε webhook όταν κάποιος κατεβάσει. Το API περιλαμβάνεται στο Pro και στο Team, ακολουθεί τα ίδια όρια με την εφαρμογή web και περιγράφεται σε δημόσιο έγγραφο OpenAPI 3.1. Τα κλειδιά δοκιμής σάς επιτρέπουν να αναπτύσσετε και να τρέχετε δοκιμές χωρίς να στέλνονται πραγματικά email και χωρίς να καταναλώνεται ο αποθηκευτικός σας χώρος.
REST API με περιγραφή OpenAPI 3.1
Όλα τα endpoints βρίσκονται κάτω από το /api/v1 και χρησιμοποιούν JSON. Η πιστοποίηση γίνεται με κλειδί API στην κεφαλίδα Authorization ως Bearer token. Τα κλειδιά δημιουργούνται στον πίνακα ελέγχου σας, εμφανίζονται μόνο μία φορά και μπορούν να περιοριστούν σε μόνο ανάγνωση, ανάγνωση και εγγραφή ή πλήρη πρόσβαση, ώστε ένα script αναφορών να μην αποκτά ποτέ δικαίωμα διαγραφής μεταφορών. Ολόκληρο το API περιγράφεται σε μηχαναγνώσιμο έγγραφο OpenAPI 3.1 στο /api/v1/openapi.json, το οποίο μπορείτε να φορτώσετε στο Postman, να δημιουργήσετε από αυτό client ή να το δώσετε σε έναν βοηθό προγραμματισμού AI. Ο οδηγός για developers στο /developers εξηγεί τις βασικές έννοιες, και η τεκμηρίωση αναφοράς API στο /developers/api παραθέτει κάθε endpoint με παραδείγματα. Κάθε απάντηση φέρει αναγνωριστικό αιτήματος, τα όρια ρυθμού αναφέρονται σε κεφαλίδες RateLimit, οι λίστες χρησιμοποιούν σελιδοποίηση με cursor και τα σφάλματα έχουν ενιαία μορφή JSON.
Συνεχιζόμενα ανεβάσματα με tus
Τα μεγάλα αρχεία και τα ασταθή δίκτυα δεν ταιριάζουν με ένα μοναδικό, μακρύ αίτημα HTTP. Για να στείλετε αρχεία, δημιουργείτε πρώτα μια μεταφορά με POST /api/v1/transfers, δηλώνοντας τα αρχεία, τον τίτλο, το μήνυμα και, αν θέλετε, τις διευθύνσεις email των παραληπτών. Στη συνέχεια κάθε αρχείο ανεβαίνει με tus, το ανοιχτό πρωτόκολλο για συνεχιζόμενα ανεβάσματα, οπότε μετά από διακοπή της σύνδεσης ή επανεκκίνηση του server το ανέβασμα συνεχίζει από το τελευταίο byte αντί να ξεκινά από την αρχή. Υπάρχουν έτοιμοι clients tus για JavaScript, Python, Go, Java, .NET, Swift και άλλες γλώσσες. Όταν ανέβουν όλα τα αρχεία, καλείτε το complete και η μεταφορά γίνεται ένας κανονικός σύνδεσμος Pandafile με σελίδα λήψης, προσωπικούς συνδέσμους για τους παραλήπτες, υπενθυμίσεις και ημερομηνία λήξης. Ισχύουν τα ίδια όρια προγράμματος όπως στον browser: στο Pro, έως 1000 GB ανά μεταφορά και 1500 GB αποθηκευτικός χώρος.
Στείλτε αρχεία απευθείας από URL
Μερικές φορές το αρχείο βρίσκεται ήδη κάπου αλλού: ένα συνημμένο στο CRM, η έξοδος ενός render farm ή ένα export σε άλλον server. Το POST /api/v1/transfers/from-url δέχεται URL με HTTPS και αφήνει το Pandafile να ανακτήσει τα αρχεία για εσάς, και στη συνέχεια δημιουργεί και ολοκληρώνει τη μεταφορά. Το αίτημα περιμένει έως 20 δευτερόλεπτα. Οι μικρές εισαγωγές επιστρέφουν ολοκληρωμένες, ενώ οι μεγαλύτερες επιστρέφουν αμέσως με κατάσταση uploading και η εισαγωγή συνεχίζεται στο παρασκήνιο. Μπορείτε να παρακολουθείτε την πρόοδο με GET /api/v1/transfers/{id}/import ή απλώς να περιμένετε το webhook transfer.ready. Με τον ίδιο τρόπο στέλνουν αρχεία και οι ενσωματώσεις Zapier και Make, χωρίς η ροή εργασίας σας να χρειάζεται να τα κατεβάσει πρώτα.
Webhooks και ειδοποιήσεις
Αντί για συνεχή ερωτήματα (polling), εγγραφείτε σε συμβάντα. Το Pandafile μπορεί να καλέσει το URL σας όταν μια μεταφορά είναι έτοιμη, έχει γίνει λήψη ή έχει λήξει, όταν ένας παραλήπτης εγκρίνει τα αρχεία ή ζητά αλλαγές, όταν κάποιος ανεβάσει σε ένα από τα αιτήματα αρχείων σας και όταν ολοκληρωθεί ένα αίτημα υπογραφής. Κάθε αποστολή υπογράφεται με HMAC-SHA256 σε κεφαλίδα Pandafile-Signature, ώστε να επαληθεύετε ότι προέρχεται πράγματι από εμάς, και οι αποτυχημένες αποστολές επαναλαμβάνονται μετά από 1 λεπτό, 5 λεπτά, 30 λεπτά, 2 ώρες και 12 ώρες. Τα συμβάντα διατηρούνται επίσης για 30 ημέρες και μπορείτε να τα διαβάσετε με GET /api/v1/events. Αν δεν χρειάζεστε καθόλου κώδικα, τα ίδια συμβάντα μπορούν να δημοσιεύουν μηνύματα στο Slack, στο Microsoft Teams ή στο Discord.
Κλειδιά δοκιμής, ασφαλείς επαναλήψεις και τι άλλο αυτοματοποιείται
Τα κλειδιά API έχουν δύο λειτουργίες. Τα κλειδιά παραγωγής ξεκινούν με pf_live_ και τα κλειδιά δοκιμής με pf_test_. Οι μεταφορές που δημιουργούνται με κλειδί δοκιμής δεν στέλνουν ποτέ email, δεν μετρούν στον αποθηκευτικό χώρο ή στη χρήση σας, διατηρούνται μόνο 24 ώρες και δεν εμφανίζονται στην κανονική λίστα μεταφορών σας, οπότε μπορείτε να τρέχετε δοκιμές ενσωμάτωσης στο πραγματικό API χωρίς παρενέργειες. Τα αιτήματα POST και PATCH δέχονται κεφαλίδα Idempotency-Key, ώστε ένα επαναλαμβανόμενο αίτημα να μη δημιουργεί ποτέ δεύτερη μεταφορά. Πέρα από τις μεταφορές, το API καλύπτει παραλήπτες και υπενθυμίσεις, ιστορικό λήψεων, στατιστικά συνδέσμων και εγκρίσεις, αιτήματα αρχείων, αιτήματα υπογραφής, branding και προσκλήσεις ομάδας. Το API περιλαμβάνεται στο Pro, από $5.99 τον μήνα ή $49.99 τον χρόνο, και στο Team, από $14.99 τον μήνα ή $129.99 τον χρόνο. Σε μια ομάδα, κάθε μέλος έχει τα δικά του προσωπικά κλειδιά.
Οδηγός για developers · Τεκμηρίωση αναφοράς API · Έγγραφο OpenAPI 3.1
Ερωτήσεις
Έχει το Pandafile API;
Ναι. Το Pandafile διαθέτει REST API κάτω από το /api/v1 για δημιουργία μεταφορών, ανέβασμα αρχείων, διαχείριση παραληπτών, αιτημάτων αρχείων και αιτημάτων υπογραφής, καθώς και για λήψη webhooks. Περιλαμβάνεται στα προγράμματα Pro και Team.
Πού βρίσκεται η τεκμηρίωση του API;
Ο οδηγός για developers βρίσκεται στο /developers και η πλήρης τεκμηρίωση αναφοράς API με παραδείγματα στο /developers/api. Το μηχαναγνώσιμο έγγραφο OpenAPI 3.1 είναι δημόσιο στο /api/v1/openapi.json.
Συνεχίζεται το ανέβασμα αν πέσει η σύνδεση;
Ναι. Τα αρχεία ανεβαίνουν με το πρωτόκολλο tus για συνεχιζόμενα ανεβάσματα, οπότε ένα ανέβασμα που διακόπηκε συνεχίζει από εκεί που σταμάτησε αντί να ξεκινά από την αρχή.
Μπορώ να κάνω δοκιμές χωρίς να στέλνονται πραγματικά email;
Ναι. Χρησιμοποιήστε κλειδί δοκιμής που ξεκινά με pf_test_. Οι δοκιμαστικές μεταφορές δεν στέλνουν ποτέ email, δεν μετρούν στον αποθηκευτικό χώρο ή στη χρήση σας και διαγράφονται μετά από 24 ώρες.
Μπορώ να στείλω ένα αρχείο που είναι ήδη online;
Ναι. Το POST /api/v1/transfers/from-url ανακτά αρχεία από URL με HTTPS και τα μετατρέπει σε μεταφορά. Οι μεγαλύτερες εισαγωγές συνεχίζονται στο παρασκήνιο, και το webhook transfer.ready σάς ενημερώνει όταν ο σύνδεσμος είναι έτοιμος.
Διαβάστε τον οδηγό για developers
Δημοφιλή
- Έγκριση αρχείων από πελάτες
- Κοινή χρήση αρχείων για ομάδες
- Δείτε ποιος κατέβασε τα αρχεία σας
- Μεταφορά αρχείων με κρυπτογράφηση από άκρο σε άκρο
- Μεταφορά αρχείων για φωτογράφους, σε πλήρη ποιότητα
- Μεταφορά αρχείων για βιντεογράφους και μοντέρ
- Δωρεάν μεταφορά αρχείων έως 50 GB, χωρίς λογαριασμό
- Στείλτε μεγάλα αρχεία δωρεάν, έως 50 GB
- Στείλτε μεγάλα αρχεία βίντεο σε πλήρη ποιότητα
- Στείλτε ένα αρχείο 1 GB δωρεάν, σε λίγα δευτερόλεπτα
- Στείλτε μεγάλα αρχεία από το iPhone σας, χωρίς εφαρμογή
- Pandafile ή WeTransfer: μια ειλικρινής σύγκριση