Коли потрібен PDF у форматі Base64?
JSON, XML і багато форм можуть передавати лише текст, тож двійковий файл, як-от PDF, спершу треба записати текстом. Найпоширеніший спосіб — Base64:
- Надсилання документа в API. Сервіси електронних рахунків, електронного підпису, доставки й документообігу часто просять передати PDF у полі з назвою content, file чи data.
- Тестування власної інтеграції. Варіант JSON дає готове тіло запиту, яке можна вставити в Postman, curl або модульний тест, не пишучи жодного коду для кодування.
- Зберігання в текстовому стовпці чи конфігурації. Деякі системи зберігають невеликі шаблони або сертифікати як текст; Base64 дає змогу вмістити туди й PDF.
- Вбудовування у вебсторінку. Data URI дає змогу показати PDF на сторінці в iframe без розміщення окремого файлу — це зручно для невеликих документів.
Покрокові приклади запитів на curl, JavaScript і Python є в посібнику Як надіслати PDF в API у форматі Base64. Щоб перетворити код назад на файл, скористайтеся інструментом Base64 в PDF; для зображень є інструмент Зображення в Base64.
Як виглядає кожен формат
| Формат | Починається з | Типове застосування |
|---|---|---|
| Лише Base64-код | JVBERi0 | Поля API, JSON, XML, бази даних |
| Data URI | data:application/pdf;base64, | Вкладка браузера, iframe, тег object |
| Рядки по 76 символів | JVBERi0, розбитий на короткі рядки | Вкладення в листах (MIME), файли у стилі PEM |
| JSON | { "fileName": … } | Тіло запиту для тестування інтеграції |
Якщо щось пішло не так
«Цей файл не є коректним PDF». Файл не починається із сигнатури %PDF- — можливо, це документ Word чи зображення, перейменоване на .pdf. Спершу відкрийте його в програмі для перегляду PDF або конвертуйте відповідним інструментом.
API повідомляє, що вміст некоректний. Перевірте, чи ви надіслали чистий код без префікса data: і без розривів рядків, якщо документація не вимагає іншого. Також переконайтеся, що під час вставлення нічого не обрізалося в кінці.
Текст задовгий для поля. Зменште PDF за допомогою інструмента Стиснути PDF і перетворіть його знову — код скоротиться пропорційно.