Pandafile · 50 ГБ безкоштовно щотижня
API для передачі файлів із ваших застосунків і процесів
Pandafile має REST API для надсилання великих файлів із вашого коду, серверів і no-code-інструментів. Створіть передачу, завантажте файли з відновленням, надішліть отримувачам персональні посилання поштою й отримайте вебхук, коли хтось завантажить файли. API входить у Pro і Team, працює з тими самими лімітами, що й вебзастосунок, і описаний у публічному документі OpenAPI 3.1. Тестові ключі дають змогу розробляти й запускати тести, не надсилаючи справжніх листів і не витрачаючи сховище.
REST API з описом в OpenAPI 3.1
Усі ендпоінти розміщені під /api/v1 і працюють із JSON. Автентифікація – за API-ключем у заголовку Authorization у вигляді Bearer-токена. Ключі створюються в особистому кабінеті, показуються лише один раз і можуть мати обмежені права: тільки читання, читання й запис або повний доступ, тож скрипт для звітів ніколи не зможе видаляти передачі. Увесь API описано в машинночитному документі OpenAPI 3.1 за адресою /api/v1/openapi.json: його можна завантажити в Postman, згенерувати за ним клієнт або передати ШІ-асистенту для програмування. Посібник для розробників на /developers пояснює основні поняття, а довідник API на /developers/api містить усі ендпоінти з прикладами. Кожна відповідь має ID запиту, ліміти запитів передаються в заголовках RateLimit, списки використовують курсорну пагінацію, а помилки приходять в єдиному форматі JSON.
Завантаження з відновленням через tus
Великі файли й нестабільна мережа погано поєднуються з одним довгим HTTP-запитом. Щоб надіслати файли, спершу створіть передачу через POST /api/v1/transfers, вказавши файли, заголовок, повідомлення й за бажанням email-адреси отримувачів. Потім кожен файл завантажується через tus – відкритий протокол для завантажень із відновленням, тож після обриву з’єднання чи перезапуску сервера завантаження продовжиться з останнього байта, а не почнеться заново. Готові tus-клієнти є для JavaScript, Python, Go, Java, .NET, Swift та інших мов. Коли всі файли завантажено, ви викликаєте complete, і передача стає звичайним посиланням Pandafile зі сторінкою завантаження, персональними посиланнями для отримувачів, нагадуваннями й строком дії. Ліміти тарифу ті самі, що й у браузері: до 1000 ГБ за передачу і 1500 ГБ сховища в Pro.
Надсилайте файли просто за URL
Іноді файл уже лежить деінде: вкладення в CRM, результат рендер-ферми чи вивантаження на іншому сервері. POST /api/v1/transfers/from-url приймає HTTPS-адреси, і Pandafile сам забирає файли, а потім створює й завершує передачу. Запит чекає до 20 секунд. Невеликий імпорт повертається вже готовим, а більший одразу відповідає статусом uploading і продовжується у фоні. Стежити за прогресом можна через GET /api/v1/transfers/{id}/import або просто дочекатися вебхука transfer.ready. Саме так інтеграції із Zapier і Make надсилають файли, не змушуючи ваш сценарій спершу їх завантажувати.
Вебхуки й сповіщення
Замість постійного опитування підпишіться на події. 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_. Передачі, створені тестовим ключем, ніколи не надсилають листів, не враховуються у сховищі та використанні, зберігаються лише 24 години й не з’являються у вашому звичайному списку передач, тож можна запускати інтеграційні тести проти справжнього API без побічних ефектів. Запити POST і PATCH приймають заголовок Idempotency-Key, тому повторний запит ніколи не створить другу передачу. Окрім передач, API охоплює отримувачів і нагадування, історію завантажень, статистику посилань і схвалення, запити файлів, запити на підпис, брендинг і запрошення до команди. API входить у Pro – від $5.99 на місяць або $49.99 на рік – і в Team – від $14.99 на місяць або $129.99 на рік. У команді кожен учасник має власні особисті ключі.
Посібник для розробників · Довідник API · Документ OpenAPI 3.1
Запитання
Чи має Pandafile API?
Так. Pandafile має REST API під /api/v1 для створення передач, завантаження файлів, керування отримувачами, запитами файлів і запитами на підпис, а також для отримання вебхуків. Він входить у тарифи Pro і Team.
Де знайти документацію API?
Посібник для розробників розміщено на /developers, а повний довідник API з прикладами – на /developers/api. Машинночитний документ OpenAPI 3.1 публічно доступний за адресою /api/v1/openapi.json.
Чи продовжиться завантаження, якщо з’єднання обірветься?
Так. Файли завантажуються через протокол tus для завантажень із відновленням, тож перерване завантаження продовжується з місця зупинки, а не починається заново.
Чи можна тестувати, не надсилаючи справжніх листів?
Так. Використовуйте тестовий ключ, що починається з pf_test_. Тестові передачі ніколи не надсилають листів, не враховуються у сховищі та використанні й видаляються через 24 години.
Чи можна надіслати файл, який уже є в інтернеті?
Так. POST /api/v1/transfers/from-url забирає файли за HTTPS-адресами й перетворює їх на передачу. Більший імпорт продовжується у фоні, а вебхук transfer.ready повідомить, коли посилання готове.
Відкрити посібник для розробників
Популярне
- Погодження файлів із клієнтом
- Обмін файлами для команди
- Дізнайтеся, хто завантажив ваші файли
- Передача файлів із наскрізним шифруванням
- Передача файлів для фотографів у повній якості
- Передача файлів для відеографів і монтажерів
- Безкоштовна передача файлів до 50 ГБ без реєстрації
- Як надіслати великий файл безкоштовно – до 50 ГБ
- Як надіслати велике відео без втрати якості
- Надіслати файл 1 ГБ безкоштовно за лічені секунди
- Надіслати великі файли з iPhone без застосунку
- Pandafile чи WeTransfer: чесне порівняння