API-ключі, права доступу й тестовий режим

4 хв читання · Оновлено 2026-11-15

Коротка відповідь

У Pro і Team створюй API-ключі в розділі Особистий кабінет > «Домен і API». Кожен ключ має доступ («Лише читання», «Читання й запис» чи «Повний доступ») і режим: робочі ключі (pf_live_) працюють по-справжньому, тестові (pf_test_) нікому не надсилають листів, а їхні передавання закінчуються через 24 години.

API Pandafile дає змогу твоїм застосункам, скриптам і серверам надсилати файли, збирати завантаження й запитувати підписи. Він входить у Pro і Team і має ті самі обмеження, що й сайт. Усе починається з API-ключа.

Як створити ключ

  1. Увійди й відкрий Особистий кабінет > «Домен і API».
  2. У розділі «API-ключі» дай ключу назву, наприклад «Завантаження з сайту».
  3. Обери режим ключа – «Робочий» чи «Тестовий» – і доступ ключа: «Повний доступ», «Читання й запис» або «Лише читання».
  4. Натисни «Створити ключ» і одразу скопіюй ключ. З міркувань безпеки ми показуємо його лише раз.
  5. Надсилай його з кожним запитом у заголовку Authorization: Bearer, а за ним – ключ.

Можна мати до 10 активних ключів. Робочі ключі починаються з pf_live_, тестові – з pf_test_. Посібник для розробників – на pandafile.co/developers, довідник API – на pandafile.co/developers/api.

Доступ: що може ключ

  • «Лише читання»: тільки GET-запити. Ключ може шукати й переглядати, але нічого не змінює.
  • «Читання й запис»: усе з «Лише читання», а також створення, зміна й видалення передавань, запитів файлів, запитів на підпис і підписок на вебхуки.
  • «Повний доступ»: усе, включно з налаштуваннями акаунта, як-от брендинг і запрошення в команду.

Тестовий режим

  • Передавання, створені ключем pf_test_, – це тестові дані. Нікому ніколи не надсилаються листи, навіть отримувачам, яких ти додаєш.
  • Тестові передавання завжди закінчуються через 24 години після створення, і продовжити їх не можна.
  • Вони не враховуються в жодних лімітах, сховищі чи використанні й не з’являються у звичайних списках передавань.
  • Події вебхуків про них мають livemode зі значенням false і ніколи не надходять у Slack, Microsoft Teams чи Discord.
  • Кілька дій працюють лише з робочим ключем. З тестовим ключем API тоді відповідає помилкою test_mode_unsupported.

Як берегти ключі

  • Будь-хто з ключем може надсилати файли з твого акаунта. Зберігай ключі на сервері, ніколи не в публічному коді сайту чи застосунку.
  • Відклич ключ у розділі Особистий кабінет > «Домен і API», якщо він міг потрапити до чужих рук. Застосунки з ним одразу перестануть працювати, а підписки на вебхуки, створені з ним, наприклад через Zapier чи Make, теж зупиняться.
  • Кожен ключ має власний ліміт запитів. Кожна відповідь показує, скільки лишилося, у заголовках RateLimit.
  • У команді API-ключі особисті: кожен учасник створює власні.
Готові надсилати?

До 50 ГБ безкоштовно за передачу, обліковий запис не потрібен.

Надіслати файли