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: честное сравнение