PDFCrowd API: возможности, тарифы, ограничения и интеграция в 2026 году
PDFCrowd API — не редактор и не просмотрщик PDF, а облачный сервис для серверной автоматизации конвертации документов. Он принимает HTML, URL, PDF и изображения, возвращает PDF, HTML, текст или растровые форматы в зависимости от выбранного конвертера и вызывается через HTTPS, официальные клиентские библиотеки либо командную строку. Поэтому оценивать его логичнее не по удобству ручного редактирования, а по качеству API-контракта, управляемости рендеринга, формату тарификации, ограничениям очереди и тому, насколько безопасно встроить удалённую обработку документов в приложение.
| Параметр | Актуальное состояние |
|---|---|
| Разработчик | Pdfcrowd s.r.o., Чехия |
| Тип | Облачный HTTP API для конвертации и обработки документов |
| Текущая ветка | API v2, актуальный конвертер 24.04 |
| Основные направления | HTML → PDF/изображение, PDF → HTML/текст/изображение/PDF, изображение → PDF/изображение, Invoice PDF API |
| Интеграция | HTTP/HTTPS, PHP, Java, .NET, Python, Node.js, Ruby, Go, командная строка |
| Работа без интернета | Нет, конвертация выполняется на серверах PDFCrowd |
| Пробный режим | 100 тестовых API-кредитов на один месяц |
| Базовая единица тарификации | 1 кредит за каждые начатые 0,5 МБ выходных данных |
| Максимальная загрузка | 300 МБ на запрос |
| Общий лимит конвертации | 60 секунд |
Скачать PDFCrowd API
Новейшая версия для Виндовс, macOS и Линукс. Удобный редактор PDF под российские реалии.
Сам PDFCrowd API скачивать не требуется: это веб-сервис, к которому приложение обращается по HTTPS. Безопасный путь начала работы — официальная документация PDFCrowd и официальные пакеты для нужного языка. Для прямого HTTP-доступа достаточно клиента, способного отправлять POST-запросы; для Python доступен пакет pdfcrowd через PyPI, для PHP — пакет pdfcrowd/pdfcrowd через Composer, для .NET — официальный пакет Pdfcrowd.Official через NuGet. Документация также предлагает Java, Node.js, Ruby, Go и набор командных утилит.
На момент проверки новые интеграции должны ориентироваться на API v2 и конвертер 24.04. Старые ветки 20.10 и 18.10 ещё доступны для совместимости, но помечены как frozen: они не получают новых функций и исправлений. Адрес с идентификатором latest в HTTP API объявлен устаревшим, поэтому фиксированный номер конвертера предпочтительнее и для воспроизводимости, и для контроля обновлений.
Для ознакомительных запросов документация показывает общие демонстрационные учётные данные. Для производственной эксплуатации нужны собственные имя пользователя PDFCrowd и API-ключ. Ключ следует хранить на сервере или в менеджере секретов, а не вставлять в клиентский JavaScript, мобильное приложение либо публичный репозиторий.
Что такое PDFCrowd API
Оператором PDFCrowd является чешская компания Pdfcrowd s.r.o. Текущий PDFCrowd API представляет собой набор облачных конвертеров с единым подходом к аутентификации и интеграции. Его не следует смешивать с онлайн-инструментами PDFCrowd для ручной работы, плагинами WordPress и клиентскими библиотеками: это отдельные способы и оболочки работы с сервисами PDFCrowd, а не настольная редакция API.
Актуальный API v2 предназначен прежде всего для бэкендов, веб-приложений и автоматизированных процессов, где документ должен создаваться или преобразовываться без участия оператора. Типичные задачи — формирование PDF из HTML-шаблона, печатное представление веб-страницы, пакетная обработка PDF, извлечение текста, рендеринг страниц PDF в изображения и подготовка изображений к выдаче.
Сервис остаётся действующим и развивается вокруг конвертера 24.04. В отличие от локальных программ вроде PDF24 Creator или настольных редакторов, вычислительная часть PDFCrowd находится на стороне провайдера. Это снижает требования к серверу заказчика, но делает интернет-соединение, доступность внешней инфраструктуры и политика обработки данных критическими зависимостями.
Основные функции PDFCrowd API
HTML в PDF: основное направление
HTML to PDF API принимает публичный URL, локальный HTML-файл либо строку HTML. Для страницы можно задавать размер и ориентацию листа, поля, разрывы, колонтитулы, масштаб и ширину виртуального окна. Поддерживаются дополнительные CSS и JavaScript, что позволяет адаптировать экранный макет под печать без изменения исходного сайта. Для динамических страниц предусмотрены задержка JavaScript и ожидание появления указанного элемента; это полезнее фиксированной паузы, если документ считается готовым только после загрузки таблицы, графика или результата AJAX-запроса.
На выходе можно настраивать метаданные, водяные знаки и фон, включать линеаризацию для быстрой веб-загрузки, ставить пользовательский и владельческий пароль, а также запрещать печать, изменение или копирование. Эти флаги следует рассматривать как средства управления PDF-документом, а не как полноценную систему контроля доступа: если исходные данные конфиденциальны, защита должна начинаться ещё до передачи их в API.
Шаблоны и данные
HTML-конвертер поддерживает шаблонный рендеринг, поэтому макет можно отделить от бизнес-данных и использовать повторно для счетов, билетов, сертификатов или отчётов. Это удобнее, чем хранить отдельный готовый HTML для каждой записи.
PDF в PDF: объединение и операции со страницами
PDF to PDF API умеет объединять несколько PDF в один, добавлять водяной знак, линеаризовать результат, извлекать либо удалять диапазоны страниц и изменять свойства документа. Это не визуальный редактор наподобие Adobe Acrobat Pro: сценарий задаётся параметрами запроса, а результат приходит как новый файл. Такой подход особенно удобен в серверных цепочках, где нужно, например, собрать обложку, коммерческое предложение и приложение в фиксированном порядке.
PDF в HTML, текст и изображения
Для обратного направления доступны PDF to HTML, PDF to Text и PDF to Image. HTML-конвертер может встраивать изображения и CSS в один файл либо выдавать их отдельными ресурсами в архиве. PDF to Text предназначен для извлечения текста с сохранением структуры расположения настолько, насколько это позволяет конкретный документ. PDF to Image рендерит страницы в растровые файлы; многостраничный PDF обычно возвращается ZIP-архивом с отдельным изображением на каждую страницу, тогда как одностраничный результат может прийти напрямую.
Изображения в PDF и изображения в изображения
Image to PDF автоматически определяет входное изображение и формирует PDF с настройками страницы, полей, DPI, фона и водяных знаков. Image to Image выполняет ресайз, поворот, кадрирование и смену растрового формата.
Invoice PDF API
В общей линейке отдельно присутствует Invoice PDF API: он принимает структурированные данные и генерирует PDF для счетов, квитанций и коммерческих документов. Его не следует путать с универсальным HTML to PDF: первый предоставляет более предметный контракт данных, второй даёт больше контроля над произвольной HTML-разметкой. Выбор зависит от того, нужна ли готовая модель документа или собственная верстка.
Интерфейс и удобство использования
У PDFCrowd API нет единого настольного интерфейса с панелью инструментов. Основная рабочая зона разработчика — документация конкретного конвертера: обзор, установка клиента, быстрый старт, аутентификация, обработка ошибок, примеры и справочник методов. Для HTML to PDF и HTML to Image доступен Playground, где параметры рендеринга можно проверять интерактивно до переноса в код.
Удобство во многом определяется тем, каким способом подключается сервис. Прямой HTTP API прозрачен и не привязывает проект к библиотеке, но требует самостоятельно формировать multipart- или form-urlencoded-запросы и проверять HTTP-ответ. Официальный SDK короче в типовых сценариях: он оборачивает параметры в методы, умеет сохранить результат в файл или вернуть данные в память и сообщает служебные показатели вроде количества оставшихся кредитов. Командные утилиты подходят для скриптов и CI-задач, где полноценный кодовый модуль избыточен.
Порог входа невысок для разработчика, знакомого с HTTP, но количество параметров у HTML to PDF велико. На практике стоит начинать с минимального запроса и добавлять настройки только после визуальной проверки результата. Особенно это касается ширины viewport, режима печатных CSS, задержек JavaScript, загрузки iframe, пользовательских шрифтов и переопределения CSS: эти параметры могут исправить один макет и одновременно изменить другой.
Документация и имена параметров англоязычные, но рендеринг позволяет задавать locale и кодировку источника. Для русскоязычных страниц важно корректно объявлять UTF-8 и использовать доступные конвертеру шрифты.
Поддерживаемые форматы и совместимость
На уровне линейки PDFCrowd API поддерживаются восемь основных направлений конвертации: HTML → PDF, HTML → Image, PDF → HTML, PDF → Image, PDF → PDF, PDF → Text, Image → PDF и Image → Image. Дополнительно существует генерация счетов из структурированных данных. Это не универсальный офисный конвертер: в текущем перечне конвертеров нет прямых DOCX → PDF, XLSX → PDF или PPTX → PDF. Если исходные данные приходят в офисных форматах, потребуется предварительное преобразование или другой сервис.
HTML можно передавать URL, файлом или строкой. Защищённые страницы могут потребовать HTTP-аутентификацию, cookies, специальные заголовки или клиентский сертификат — такие параметры предусмотрены в HTML-конвертере. Для внутреннего ресурса, недоступного облачному сервису, практичнее передать содержимое напрямую либо организовать контролируемый сетевой доступ.
PDF to Image поддерживает PNG, JPG, GIF, TIFF, BMP, ICO, WebP и несколько специализированных растровых форматов. Для многостраничного PDF результат можно обрабатывать как набор изображений.
Совместимость с платформами определяется не Windows, macOS или Linux, а наличием HTTP/HTTPS. Официально API заявлен как доступный практически на любой платформе с сетевым HTTP-клиентом. Для популярных серверных стеков есть библиотеки PHP, Java, .NET, Python, Node.js, Ruby и Go; для прочих языков остаётся прямой HTTP. Это делает продукт удобным для контейнеров, виртуальных машин и serverless-сред, если их политика сети разрешает исходящие HTTPS-запросы.
Производительность и стабильность
PDFCrowd выполняет тяжёлую часть работы удалённо, поэтому локальная загрузка CPU и памяти в основном связана с подготовкой входных данных и приёмом результата. Скорость зависит от сложности источника, количества удалённых ресурсов, JavaScript и текущего тарифного лимита. Официальные планы ограничивают число запросов в минуту и параллельные конвертации; превышение частоты приводит к HTTP 429, превышение конкурентности — к 430.
Для тарифов также задан Max Delay — максимальное ожидание асинхронного JavaScript. В линейке планов оно увеличивается от 1 секунды на младших уровнях до 15 секунд на крупных. Это отдельный параметр, не равный общему ограничению конвертации в 60 секунд. Поэтому страница, которая требует долгого интерактивного запуска, тяжёлых сторонних скриптов или нестабильных сетевых ресурсов, может быть плохим кандидатом для синхронного HTML-рендеринга.
Максимальный размер загрузки в статусах API указан как 300 МБ. Для чрезмерно сложного или большого входа предусмотрена отдельная ошибка нехватки памяти с рекомендацией упростить данные. Это важнее абстрактной цифры размера: сложный DOM, большие изображения и ресурсоёмкий JavaScript способны упереться в лимит раньше, чем компактный статический документ такого же размера.
Для диагностики HTTP-ответ может содержать служебные данные о задании, размере выхода, страницах и кредитах, а debug log помогает искать ошибки загрузки ресурсов. Для временных 503 разумен ограниченный повтор с задержкой; постоянные ошибки входа повторять бесконечно нельзя.
Инфраструктура сервиса распределена по нескольким зонам доступности, но приложению всё равно нужны собственные тайм-ауты, ограниченные повторы и очередь для некритичных задач.
Лицензирование и версии
PDFCrowd продаётся по подписочной модели с кредитами. На 14 сентября 2026 года публичная сетка начинается с Nano за 1 доллар в месяц: 10 кредитов, 15 запросов в минуту и одна одновременная конвертация. Micro стоит 11 долларов и даёт 200 кредитов, Small — 23 доллара и 1000 кредитов, Medium — 35 долларов и 5000 кредитов, Large — 61 доллар и 10 000 кредитов, Ultimate — 106 долларов и 20 000 кредитов; выше расположены Enterprise-уровни. Перед покупкой цену следует сверять повторно.
Один кредит соответствует 0,5 МБ выходных данных. Файл до 0,5 МБ расходует один кредит, свыше 0,5 и до 1 МБ — два и так далее. Поэтому крупный каталог с изображениями может расходовать заметно больше кредитов, чем короткий текстовый PDF.
Пробный доступ включает 100 тестовых API-кредитов, действующих один месяц. Для production нужны собственные учётные данные и подходящий план. При выборе плана важны не только кредиты, но и лимит запросов в минуту, параллельность и максимальная задержка JavaScript.
Версионность устроена в три слоя. API v2 — текущая основная платформа, API v1 заморожен и недоступен новым аккаунтам. Конвертер 24.04 получает обновления, 20.10 и 18.10 заморожены. Клиентские библиотеки версионируются отдельно; ветка 6.x по умолчанию использует конвертер 24.04 и при необходимости позволяет явно выбрать старую совместимую версию. Для стабильного production-результата разумно фиксировать версию конвертера и менять её только после регрессионной проверки эталонных документов.
Полная стоимость использования
Цена подписки — только часть стоимости интеграции. Первая переменная — объём выходных файлов: поскольку кредит привязан к 0,5 МБ результата, высокое разрешение изображений, тяжёлые фоны и встроенные шрифты напрямую увеличивают расход. Перед выбором плана полезно собрать статистику по реальным типам документов, а не умножать количество файлов на условную единицу.
Вторая переменная — пропускная способность: для пиков важны rate limit и concurrency, а не только месячный запас кредитов. Дешёвый план может иметь достаточно кредитов, но не выдержать короткую массовую очередь.
Третья часть — инженерные расходы: настройка шаблонов, мониторинг ошибок 429/430/5xx, хранение секретов, визуальные регрессионные тесты при обновлении конвертера и резервная очередь. Для простого «URL в PDF» они невелики, но в сложной системе генерации документов часто оказываются существеннее самой подписки.
Системные требования
Прямой HTTP API
Для прямого доступа не опубликованы требования к конкретной ОС, процессору или объёму оперативной памяти. Нужна платформа, способная устанавливать интернет-соединение и отправлять HTTP/HTTPS-запросы. Конвертация происходит на серверах PDFCrowd, а автономного SDK для офлайн-рендеринга нет. Следовательно, требования к локальному железу зависят от приложения пользователя, а не от движка PDFCrowd.
Клиентские библиотеки и CLI
Для SDK требуется среда соответствующего языка и менеджер пакетов либо ручное подключение официальной библиотеки. Документация предлагает PHP, Java, .NET, Python, Node.js, Ruby и Go. Командные утилиты распространяются вместе с Python-пакетом pdfcrowd. Конкретные минимальные версии интерпретаторов и ОС в общих требованиях PDFCrowd не фиксируются, поэтому их следует проверять у текущего пакета и в инфраструктуре проекта, а не переносить из устаревшего примера.
Сеть и безопасность
Нужен исходящий доступ к API PDFCrowd по HTTPS. Если корпоративный сервер работает через прокси, в клиентах предусмотрены настройки HTTP/HTTPS proxy. Секреты аутентификации должны находиться на серверной стороне. Для организаций с требованиями к персональным данным нужно учитывать облачную обработку и условия DPA до передачи реальных документов.
Карта критических зависимостей
| Зависимость | Что произойдёт при сбое | Что предусмотреть |
|---|---|---|
| Интернет и DNS | Запрос не достигнет API | Тайм-аут, очередь и ограниченный повтор |
| Сервис PDFCrowd | Временные 5xx или задержка | Повтор 502/503, журнал job ID, отложенная обработка |
| API-ключ | Ошибка аутентификации | Хранение секрета, ротация и проверка конфигурации |
| Кредиты и тариф | Ограничение либо риск приостановки | Учёт consumed/remaining credits и уведомления |
| Rate limit/concurrency | HTTP 429 или 430 | Очередь, ограничитель параллельности, backoff |
| Удалённые ресурсы HTML | Пропавшие стили, шрифты, изображения | Логи загрузки, архив с ресурсами или контролируемые URL |
| Версия конвертера | Изменение рендеринга после миграции | Фиксация версии и набор эталонных документов |
Качество такой интеграции определяется не только результатом конвертации, но и поведением при сетевом сбое, исчерпании лимита и смене рендерера.
Преимущества и недостатки PDFCrowd API
Плюсы и минусы
— Широкая линейка конвертеров. Один сервис закрывает HTML, PDF и изображения, а также умеет извлекать текст и выполнять PDF-to-PDF операции.
— Гибкий HTML-рендеринг. Доступны управление страницей, CSS/JavaScript, ожидание динамического элемента, колонтитулы, водяные знаки, шифрование и метаданные.
— Несколько способов интеграции. Можно использовать прямой HTTP, семь официальных серверных SDK и командную строку.
— Предсказуемая версия движка. Конвертер можно закрепить на 24.04 и обновлять отдельно от клиентской библиотеки.
— Диагностика. API возвращает служебные заголовки с job ID, размером, страницами, кредитами и ссылкой на debug log.
— Документированная политика хранения. Переданные и созданные файлы удаляются из активных систем в течение 30 минут, резервные копии содержимого не создаются.
Минусы
— Нет офлайн-режима. Без интернета и серверов PDFCrowd конвертация невозможна.
— Тарификация зависит от размера результата. Большие PDF с изображениями расходуют несколько кредитов за один документ.
— Нет прямой офисной линейки DOCX/XLSX/PPTX. Для таких входов потребуется дополнительный преобразователь или другой API.
— Облачная передача данных требует юридической оценки. Для чувствительных документов нужно учитывать DPA, subprocessors и возможную международную обработку.
— Жёсткие эксплуатационные рамки. Есть 300-МБ лимит загрузки, общий 60-секундный предел конвертации и тарифные ограничения частоты и конкурентности.
— Сложный веб-макет требует настройки. Динамический JavaScript, внешние шрифты, iframe и нестабильные ресурсы способны сделать результат менее предсказуемым, чем статический HTML.
Сравнение с аналогами
| Решение | Основной профиль | Бесплатный режим | Сильная сторона | Ограничение относительно PDFCrowd |
|---|---|---|---|---|
| PDFCrowd API | HTML/PDF/изображения, облачная обработка | 100 тестовых кредитов на месяц | Единая линейка конвертеров и глубокие параметры HTML | Нет офлайн-режима и прямого Office → PDF |
| DocRaptor | HTML → PDF и табличные документы | Неограниченные водяные тестовые документы | Сильный печатный CSS и Prince-based PDF | Гораздо уже набор входных/выходных направлений |
| PDFShift | HTML → PDF | 50 кредитов в месяц | Простой HTML-to-PDF сценарий, CSS/JS, водяные знаки и шифрование | Не заменяет PDFCrowd для PDF → HTML/Text/Image и image-конвертаций |
| CloudConvert API | Универсальная конвертация файлов | Есть sandbox для тестовых задач на разрешённых файлах | Более 200 форматов, асинхронные job-цепочки и интеграции с хранилищами | Для тонкой печатной настройки HTML PDFCrowd предлагает более предметный API |
| Sumatra PDF | Локальный просмотр документов в Windows | Бесплатно | Быстрый офлайн-просмотр PDF и других форматов без облачной отправки | Не является API конвертации и не автоматизирует серверную генерацию |
PDFCrowd особенно уместен, когда одному приложению нужны несколько направлений обработки PDF, HTML и изображений. Для типографски сложного HTML → PDF специализированной альтернативой остаётся DocRaptor, а для максимально широкого набора форматов — CloudConvert. PDFShift ориентирован на более узкий HTML-to-PDF контур.
Sumatra PDF находится в другой категории. Это локальный просмотрщик, поэтому он лучше PDFCrowd там, где пользователь просто открывает уже готовый документ и не хочет отправлять его в облако. PDFCrowd, наоборот, нужен до этапа чтения — когда сервер должен автоматически создать, преобразовать или подготовить документ. Для ручной правки готового PDF можно рассмотреть PDF-XChange Editor, а для простых пользовательских веб-конвертаций — PDF Candy.
Инструкция по установке
Вариант без SDK: прямой HTTP
Шаг 1. Определите нужный конвертер и зафиксируйте версию 24.04 для новой интеграции.
Шаг 2. Для ознакомления используйте демонстрационные учётные данные из официальной документации; для production создайте собственные credentials.
Шаг 3. Подготовьте HTTPS POST-запрос на endpoint конвертации. При загрузке файла используйте multipart/form-data; для параметров без файлов допустим form-urlencoded.
Шаг 4. Передайте вход: URL, файл, строку HTML либо бинарные данные — в зависимости от конвертера.
Шаг 5. Сохраните тело успешного ответа как файл нужного типа и проверьте Content-Type, x-pdfcrowd-reason-code и размер результата.
Шаг 6. Добавьте обработку 4xx, 429/430 и временных 5xx до включения функции в production.
Прямой HTTP удобен для языков без официального SDK и инфраструктуры, где важно минимизировать зависимости.
Python и командная строка
Шаг 1. Создайте отдельное виртуальное окружение проекта, чтобы не смешивать зависимости.
Шаг 2. Установите официальный пакет командой pip install pdfcrowd.
Шаг 3. Сохраните PDFCrowd username и API key в переменных окружения или менеджере секретов.
Шаг 4. Создайте клиент нужного конвертера, передайте credentials и выполните один небольшой тестовый запрос.
Шаг 5. Сравните выход с исходником, затем добавьте параметры страницы, ожидания JavaScript или защиты PDF только при необходимости.
Шаг 6. Для shell-сценариев используйте командные утилиты из официального Python-пакета по документации выбранного конвертера.
На рабочем сервере не оставляйте демонстрационный ключ и не выводите production-секрет в командную историю или журнал CI. Клиентская библиотека и облачная подписка — разные сущности.
Первый безопасный запуск
Для первого запроса лучше взять короткий статический HTML без внешних ресурсов. Это отделяет проблемы аутентификации и сети от проблем рендеринга. После успешного ответа проверьте, что PDF открывается в обычном просмотрщике, например Sumatra PDF, содержит ожидаемое число страниц и не имеет случайной обрезки. Только после этого подключайте веб-шрифты, JavaScript и закрытые URL.
Паспорт обратимости операций
| Операция | Исходник изменяется? | Можно вернуть исходное состояние? | Что сохранить |
|---|---|---|---|
| HTML → PDF | Нет | Да, повторной генерацией из исходного HTML | HTML, CSS, данные шаблона, версию конвертера и параметры |
| PDF → изображение | Нет | Исходный PDF остаётся, но из изображения нельзя восстановить структуру PDF без потерь | Оригинальный PDF |
| PDF → HTML/Text | Нет | Выход не равнозначен исходному PDF | Оригинал и параметры экспорта |
| PDF → PDF с удалением страниц | Исходный загруженный файл не переписывается | Только если сохранён исходник | Исходный PDF и список страниц |
| Image → Image | Нет | Не всегда: ресайз и JPEG-компрессия могут быть необратимы | Оригинальное изображение |
Главное правило — считать API преобразователем, а не системой хранения и версий. PDFCrowd удаляет содержимое после обработки и не создаёт резервные копии пользовательских файлов. Поэтому исходники, шаблоны и параметры запроса должны храниться в вашей системе. Для воспроизводимого PDF к ним следует добавить номер конвертера, поскольку смена версии способна изменить верстку.
Практические кейсы
Серверный счёт из HTML-шаблона
Цель: сформировать PDF-счёт после оформления заказа. Подготовка: HTML-шаблон, данные заказа, корректный UTF-8, серверные credentials. Шаги: подставить данные в шаблон или передать их через механизм template rendering, вызвать HTML to PDF, задать размер страницы и при необходимости колонтитул, сохранить ответ в объектное хранилище приложения. Проверка: убедиться, что присутствуют номер заказа, итоговая сумма и все страницы, а Content-Type соответствует PDF. Ограничение: внешние шрифты и изображения делают результат зависимым от доступности сторонних URL; для критичных документов лучше контролировать ресурсы.
Архивная копия динамической веб-страницы
Цель: сохранить состояние отчёта после загрузки данных. Подготовка: публичный или авторизуемый URL и CSS-селектор элемента, который появляется после завершения загрузки. Шаги: передать URL, при необходимости cookies или HTTP-auth, использовать ожидание элемента вместо большой фиксированной задержки, затем конвертировать только нужную область либо всю страницу. Проверка: сравнить ключевые числа и графики с веб-версией и проверить debug log на ошибки ресурсов. Ограничение: Max Delay зависит от тарифа, а общая конвертация ограничена 60 секундами.
Пакетное объединение PDF
Цель: собрать комплект из обложки, договора и приложений. Подготовка: исходные PDF в правильном порядке и список ожидаемых страниц. Шаги: передать файлы в PDF to PDF, при необходимости добавить водяной знак или выполнить линеаризацию, сохранить новый PDF. Проверка: сверить x-pdfcrowd-pages с ожидаемым количеством и открыть результат в независимом просмотрщике. Ограничение: операция не заменяет визуальное редактирование содержимого страницы; ошибки исходного PDF переносятся в итоговый документ.
Превью страниц PDF для веб-каталога
Цель: получить изображения страниц без локального PDF-рендерера. Подготовка: PDF, диапазон страниц и требуемый DPI. Шаги: вызвать PDF to Image с PNG или WebP, ограничить page range, при необходимости включить ZIP даже для единообразной обработки. Проверка: сверить число файлов и визуально проверить первую и последнюю страницу. Ограничение: высокое DPI увеличивает объём результата и расход кредитов, поэтому для миниатюр нет смысла использовать печатное разрешение.
Навигатор по сбоям
| Симптом | Первая проверка | Вероятная причина | Безопасное действие |
|---|---|---|---|
| 401/ошибка credentials | Имя пользователя и API key | Неверная аутентификация | Сверить секреты и не печатать их в лог |
| 429 | Запросы за последнюю минуту | Превышен rate limit | Уменьшить частоту, применить очередь/backoff |
| 430 | Число одновременных задач | Превышена concurrency | Ограничить воркеры или сменить план |
| 413 | Размер входа | Загрузка более 300 МБ | Уменьшить данные или изменить архитектуру |
| 306 reason code | Сложность DOM/изображений | Недостаточно памяти конвертера | Упростить источник, уменьшить ресурсы |
| 502/503 | Повторяемость на том же входе | Временный сетевой/серверный сбой | Ограниченный повтор с задержкой |
| Нет стилей или картинок | Debug log и доступность URL | Ресурс заблокирован или не успел загрузиться | Исправить URL, auth, архив ресурсов или ожидание |
Контроль перед сохранением и передачей
— Проверить HTTP-статус, reason code и Content-Type, а не только наличие ненулевого файла.
— Сверить число страниц и размер результата с допустимым диапазоном для данного типа документа.
— Открыть PDF независимым просмотрщиком и проверить первую, среднюю и последнюю страницы.
— Для HTML-источника проверить шрифты, таблицы, графики, колонтитулы и места разрыва страниц.
— Для конфиденциального результата убедиться, что пароль и ограничения PDF заданы осознанно, а исходные данные разрешено передавать облачному процессору.
— Записать job ID, версию конвертера и собственный идентификатор документа, но не API key и не чувствительное содержимое.
— Сопоставить consumed credits с ожидаемым размером, чтобы неожиданно тяжёлые документы не исчерпали план.
Часто задаваемые вопросы
Можно ли использовать PDFCrowd API полностью бесплатно?
Постоянного безлимитного бесплатного API-плана в публичной сетке нет. Для знакомства предоставляются 100 тестовых кредитов на один месяц, а документация также содержит демонстрационные credentials для примеров. Production следует рассчитывать на платную лицензию или иной официально доступный тариф.
Хранит ли PDFCrowd загруженные документы?
Сервис заявляет, что загруженные файлы, переданный HTML и созданные PDF/изображения хранятся только на время обработки и выдачи результата, после чего удаляются из активных систем в течение 30 минут; резервные копии этого содержимого не создаются. При этом URL конвертируемых страниц может сохраняться в журнале аккаунта: по умолчанию срок составляет 14 дней, а настройка позволяет отключить хранение URL.
Подходит ли API для персональных или коммерчески чувствительных данных?
Технически сервис предусматривает DPA, меры шифрования доступа, контроль доступа и список subprocessors. Но пригодность для конкретной категории данных определяет сама организация: нужно проверить правовое основание, договор обработки, маршруты международной передачи и внутренние требования. Сам факт наличия HTTPS не заменяет такую оценку.
Можно ли получить DOCX из PDF?
В текущем перечне конвертеров PDFCrowd API прямого PDF → DOCX нет. Доступны PDF → HTML, Text, Image и PDF, поэтому для Word-формата нужен другой конвертер или дополнительный этап обработки.
Есть ли встроенный OCR для сканов?
В основной публичной линейке PDFCrowd API отдельный OCR-конвертер не заявлен. PDF to Text извлекает текст из PDF, но не следует приравнивать это к гарантированному OCR для страниц, состоящих только из изображений. Если сканы — ключевой сценарий, разумнее использовать специализированное OCR-решение, например рассмотреть класс программ, к которому относится ABBYY FineReader.
Почему одинаковый документ после обновления может выглядеть иначе?
Версия конвертера — отдельная часть продукта. Новая ветка меняет поддержку веб-технологий и алгоритмы рендеринга, поэтому поставщик рекомендует тестировать переход. Для production лучше явно закреплять конвертер 24.04 и хранить набор эталонных документов для сравнения перед будущей миграцией.
Вывод
PDFCrowd API подходит разработчикам и компаниям, которым нужно автоматически создавать и преобразовывать документы на сервере без эксплуатации собственного PDF-движка. Его сильная сторона — сочетание глубокого HTML → PDF с операциями PDF → PDF, HTML/Text/Image и обработкой изображений, доступными через единый облачный контур. Для интеграций с веб-отчётами, счетами, архивными копиями страниц и генерацией превью это практичный набор.
Выбирать его следует с учётом трёх условий: документы допустимо передавать внешнему облачному процессору, приложению подходит тарификация по размеру выхода, а архитектура выдерживает лимиты времени, частоты и конкурентности. Если нужен полностью локальный процесс, PDFCrowd не подходит. Если основной вход — DOCX/XLSX/PPTX, целесообразнее сервис с прямой поддержкой Office. Если задача — только читать готовые PDF на Windows, проще использовать Sumatra PDF; если требуется ручное редактирование, нужен настольный PDF-редактор, а не API.
Для новой интеграции разумно начать с минимального запроса на API v2/24.04, зафиксировать версию конвертера и только затем добавлять сложные параметры рендеринга, контроль ошибок и лимитов.