API-ключі, права доступу й тестовий режим
Коротка відповідь
У Pro і Team створюй API-ключі в розділі Особистий кабінет > «Домен і API». Кожен ключ має доступ («Лише читання», «Читання й запис» чи «Повний доступ») і режим: робочі ключі (pf_live_) працюють по-справжньому, тестові (pf_test_) нікому не надсилають листів, а їхні передавання закінчуються через 24 години.
API Pandafile дає змогу твоїм застосункам, скриптам і серверам надсилати файли, збирати завантаження й запитувати підписи. Він входить у Pro і Team і має ті самі обмеження, що й сайт. Усе починається з API-ключа.
Як створити ключ
- Увійди й відкрий Особистий кабінет > «Домен і API».
- У розділі «API-ключі» дай ключу назву, наприклад «Завантаження з сайту».
- Обери режим ключа – «Робочий» чи «Тестовий» – і доступ ключа: «Повний доступ», «Читання й запис» або «Лише читання».
- Натисни «Створити ключ» і одразу скопіюй ключ. З міркувань безпеки ми показуємо його лише раз.
- Надсилай його з кожним запитом у заголовку 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-ключі особисті: кожен учасник створює власні.