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 в год. В команде у каждого участника свои личные ключи.

Вопросы

Есть ли у 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 сообщит, когда ссылка готова.

Открыть руководство разработчика

Популярное