Как отправить PDF в API в формате Base64
API электронных счетов, электронной подписи или службы доставки ждёт документ в поле JSON. Рассказываем, как превратить PDF в правильный текст, проверить его и избежать ошибок, из-за которых запрос не проходит.
Автор: Metin Ersoy · Обновлено 10 ноября 2026 г.
Что обычно ждёт API
Большинство API для работы с документами описывают тело запроса в JSON с полем content, file, data или document. Его значение — Base64-код PDF, часто вместе с именем файла и типом:
{
"fileName": "invoice-1024.pdf",
"mimeType": "application/pdf",
"content": "JVBERi0xLjcKJ..."
}
Прежде чем писать код, найдите в документации три вещи: имя поля, нужен ли префикс data: (обычно нет) и ограничение по размеру.
1. Переведите PDF в Base64
Быстрее всего получить тестовое значение с помощью инструмента PDF в Base64. Выберите PDF, отметьте Только Base64-код и скопируйте результат. Если вам нужно готовое тело запроса, выберите вариант JSON — он сам добавит имя файла и тип. PDF кодируется прямо в браузере и никуда не отправляется, а это важно, когда тестовый документ — настоящий счёт.
Проверьте результат: он должен начинаться с JVBERi0, не содержать пробелов и, кроме одного-двух знаков = в конце, состоять только из букв, цифр, + и /.
2. Отправьте его из своего кода
Один и тот же шаг на трёх популярных языках. Каждый пример читает файл, кодирует его и отправляет JSON:
# curl (Linux / macOS): base64 -w 0 keeps it on one line
curl -X POST https://api.example.com/documents \
-H "Content-Type: application/json" \
-d "{\"fileName\":\"invoice.pdf\",\"content\":\"$(base64 -w 0 invoice.pdf)\"}"
// Node.js 18+
import { readFile } from 'node:fs/promises';
const content = (await readFile('invoice.pdf')).toString('base64');
await fetch('https://api.example.com/documents', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ fileName: 'invoice.pdf', content }),
});
# Python 3 with requests
import base64, requests
with open("invoice.pdf", "rb") as f:
content = base64.b64encode(f.read()).decode("ascii")
requests.post("https://api.example.com/documents",
json={"fileName": "invoice.pdf", "content": content})
На macOS в строке curl вместо -w 0 используется base64 -i invoice.pdf. Адрес и имена полей приведены для примера — берите те, что указаны в документации вашего сервиса.
3. Проверьте обратное преобразование
Если сервис возвращает документ или сохранённую копию в Base64, вставьте ответ в инструмент Base64 в PDF. Первая страница и число страниц — самое быстрое доказательство того, что по дороге ничего не потерялось. Подробные шаги для этого направления — в инструкции Как сохранить строку Base64 в PDF-файл.
Частые ошибки
| Признак | Вероятная причина | Что делать |
|---|---|---|
| «Invalid Base64» | Переносы строк (строки по 76 символов) или префикс data: | Отправляйте чистый код одной строкой |
| «Payload too large» (413) | PDF после кодирования слишком большой | Уменьшите его инструментом Сжать PDF |
| PDF открывается пустым или повреждённым | Строка обрезалась | Закодируйте файл заново и отправьте значение целиком |
| Имена с диакритикой или кириллицей отображаются неправильно | Имя файла отправлено в неверной кодировке | Держите тело JSON в UTF-8 |
Хотите попробовать? Это бесплатно, и файл остаётся на вашем устройстве.
Открыть «PDF в Base64»