Когда нужен 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 и переведите его заново — код сократится в той же пропорции.