PDFVela — pdfvela.com
Все инструменты PDF

Как отправить PDF в API в формате Base64

API электронных счетов, электронной подписи или службы доставки ждёт документ в поле JSON. Рассказываем, как превратить PDF в правильный текст, проверить его и избежать ошибок, из-за которых запрос не проходит.

Автор: · Обновлено 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»

Вопросы об отправке PDF в Base64

Почему API просят Base64, а не сам файл?

JSON умеет передавать только текст. Base64 записывает байты PDF буквами, цифрами и знаками + и /, поэтому весь документ помещается в одно строковое поле рядом с остальными данными — например, номером клиента или датой счёта.

Нужно ли отправлять префикс data:application/pdf;base64,?

Обычно нет. Большинство API ждут только сам код, который начинается с JVBERi0. Data URI отправляйте, только если он указан в документации или если браузеру нужен адрес — например, для iframe.

API пишет, что Base64 недействителен. В чём чаще всего причина?

В строке есть переносы или префикс либо код обрезался при вставке. Передавайте чистый код одной строкой и проверьте, что конец строки дошёл целиком.

Какого размера может быть PDF?

Это зависит от сервиса, но текст примерно на треть больше файла, так что PDF на 3 МБ превращается примерно в 4 МБ JSON. Многие API не принимают больше нескольких мегабайт — проще всего сначала сжать PDF.

Base64 — это шифрование?

Нет. Любой, у кого есть код, превратит его обратно в документ. Передавайте его только по HTTPS и никогда не вставляйте конфиденциальный PDF на сайт, который отправляет его на сервер.