Часто задаваемые вопросы по конвертации HTML в PDF

  1. Поддерживает ли ваш API работу с кириллицей?
  2. Какие форматы страниц поддерживаются?
  3. Как мне установить размер страницы?
  4. Я веду разработку на локальном сервере. Должен ли я его открывать наружу, что бы конвертировать мои страницы в PDF через API?
  5. Если я использую URL в запросе, как обеспечить безопасность? Могу ли я использовать HTTPS адреса ?
  6. Почему я получаю ошибку в ответе на мой запрос с URL?
  7. Как ускорить конвертацию в PDF ?
  8. Почему обрезается верхние и нижние части (колонтитулы) моей страницы?
  9. Как сделать разрыв страницы?
  10. Как обеспечивается конфиденциальность передаваемых файлов?
  11. Можно ли получить отельный выделенный сервер с отдельным API?
  12. Как узнать сколько генераций я уже использовал?
  13. Мой личный ключ к API стал известен третьим лицам. Как я могу его сменить?
  14. Что будет с моими не израсходованными конвертациями по истечении оплаченного периода, они сгорят?
  15. Наш проект не коммерческий, полностью социально направленный. Можно ли на каких-то условиях получить льготу при использовании вашего сервиса?


Поддерживает ли ваш API работу с кириллицей?

Да, в отличает от многих мы поддерживаем кириллицу и UTF кодировку. Не забываете, что ваша страница, должна иметь   в HTML точно указание <meta charset=utf-8>

Какие форматы страниц поддерживаются?

Поддерживаются все международные форматы ISO A0 A1 A2 A3 A4 A5 A6 A7 A8 A9 B0 B1 B1 B2 B3 B4 B5 B6 B7 B8 B9,  а также американские форматы, такие как Comm10E, DLE, Executive, Folio, Ledger, Legal, Letter, Tabloid.

Как мне установить размер страницы?

Вы можете использовать параметры PageWidth и PageHeight. Обратите внимание, что вы должны использовать оба параметра одновременно. Смотрите описание всех опций.

Я веду разработку на локальном сервере. Должен ли я его открывать наружу, что бы конвертировать мои страницы в PDF через API?

Нет, к тому же  лучше отправлять HTML вместо URL вашей страницы. При отправке HTML вместо URL  преобразование HTML в PDF происходит гораздо быстрее, так как нам не требуется загружать веб-страницу из интернета.

Если я использую URL  в запросе, как обеспечить безопасность? Могу ли я использовать HTTPS адреса ?

Наш API поддерживает SSL, соответственно и чтение с  HTTPS страниц. Также вы можете передавать логин и пароль в строке адреса, в качестве альтернативы некоторые клиенты используют простейшие ключи в URL,  которые ни кто не может знать, например, www.mysite.ru/reports?secret=abc123. Ключ может быть как просто строкой, так и более сложным, например одноразовым или срок действия —  минуту, час, день и т.п.

Почему я получаю ошибку в ответе на мой запрос с URL?

Вот некоторые из возможных причин.

  1. Вы передаете адрес локальной страницы, например страницы локального сервиса. В этом случае, вам следует передавать HTML.
  2. HTML или CSS содержит ссылку на внешний файл, например изображение, которого не существует. Система некоторое время будет пытаться загрузить этот несуществующий файл, что увеличивает время обработки.  Вызовите в вашем броузере консоль, нажатием клавиши F12, определите и исправьте ошибки вашей страницы.
  3. Ваша страница имеет совершенно невалидный HTML. Проверьте ваши страницы с помощью  страницы с помощью любого онлайн W3C валидатора.
  4. Ваша страница доступна по HTTPS, но она ссылается на какие-то файлы или другие ресурсы по небезопасному HTTP протоколу — это может быть причиной возникновения ошибок.  Вызовите в вашем броузере консоль, нажатием клавиши F12, определите и исправьте ошибки вашей страницы.
  5. Ваша страница имеет очень сложныt стили CSS. Это приведет к повышенному времени обработки. Градиенты, закругленные углы и т.п. в избытке могут вызывать подобные проблемы. Используете более простые стили CSS.
  6. Вы передаете HTML  и используете относительные адреса например на файлы картинок, стилей CSS, файлов шрифтов. Используйте только абсолютные адреса, например http://mysite.ru/img/mypicture.jpg вместо /img/mypicture.jpg

Для решения подобных проблем можно применить следующий прием. Используйте комментарии в HTML и в CSS для того что бы деактивировать большие части сомнительного кода и последовательно открывайте их, проверяя результат.

Как  ускорить конвертацию в PDF ?

Большинство PDF файлов генерируется сервисом в течение нескольких миллисекунд, однако достаточно сложные стили CSS могут быть причиной более медленного преобразования. Попробуйте закомментировать ссылки на ваши файлы стилей CSS и проверить скорость генерации.  Далее определив, что источником повышенного времени генерации является сложный CSS, вы можете упростить его. Часто с подобной проблемой можно столкнуться, используя сложные стили bootstrap, где этого не требуется. Например, если вам необходимо преобразовать в PDF версию для печати, вы можете использовать подобные конструкции:

@media print{
* {
color: #000 !important;
text-shadow: none !important;
background: transparent !important;
box-shadow: none !important;
}
table {
border-collapse: collapse !important;
}
table-bordered th, table-bordered td{
border: 1px solid #ddd !important;
}
}

В случае, если подобный вариант  не удовлетворяет потребностям вашего бизнеса, вы можете обратиться к нам и мы предоставим вам отдельные мощности, например отдельный выделенный виртуальный или реальный сервер.

Почему обрезается верхние и нижние части (колонтитулы) моей страницы?

По умолчанию отступы (margin) внутри документа равны 0 px. Попробуйте увеличить размер отступов, задав соответствующие значениями опций MarginTop и MarginBottom (см. описание всех опций), чтобы освободить место для верхнего и нижнего колонтитула. Также, если вы передаете URL страницы, убедитесь что HTML этой страницы содержит тег DOCTYPE  в верхней части.

Как сделать разрыв страницы?

Используйте подобную конструкцию CSS:

@media print {
   footer {page-break-after: always;}
}


Как обеспечивается конфиденциальность передаваемых файлов?

Мы относимся к этому вопросу очень серьезно, поэтому не храним ни передаваемые файлы, не адреса страниц, не генерируемые файлы, даже в журналах логов. HTML обрабатывается налету и результат сразу отправляем вам. Хранить и обрабатывать большие бесполезные для нас объемы данных не представляется возможным, так как это экономически не целесообразно, так как требует дополнительных мощностей для хранения файлов. Также это полностью противоречит нашей политике конфиденциальности.

Можно ли получить отельный выделенный сервер с отдельным API?

Да мы можем выделить под нужды вашего бизнес отдельный виртуальный или даже физический сервер.

Как узнать сколько генераций я уже использовал?

Мы автоматически отправляем уведомление на вашу электронную почту, кода использовано 60%, 80% или 100% от количества доступных конвертаций. Также в личном кабинете доступна вся необходимая статистика по расходу средств, в том числе и посуточная.

Мой личный ключ к API стал известен третьим лицам. Как я могу его сменить?

По соображениям безопасности личный ключ к API нельзя поменять самому в личном кабинете. Вам достаточно, используя форму обратной связи, написать сообщение с темой  Запрос на смену ключа к API. Мы сменим ваш ключ, и уведомим Вас об этом. Новый ключ будет доступен в личном кабинете.

Что будет с моими не израсходованными конвертациями по истечении оплаченного периода, они сгорят?

Все не израсходованные, но оплаченные вами, конвертации не сгорят, а перенесутся на следующий период, если вы успеете его продлить до истечения текущего. Бесплатный тариф продлевать не требуется, это происходит автоматически, но не израсходованные конвертации на новые период не переносятся.

Наш проект не коммерческий, полностью социально направленный. Можно ли на каких-то условиях получить льготу при использовании вашего сервиса?

Для не коммерческих организаций мы достаточно часто предоставляем наш сервис бесплатно. В таких случаях обычно бывает достаточно, если вы разместите ссылку на вашем сайте на наш сервис.


Вы не нашли ответ на ваш вопрос? Пришлите его нам прямо сейчас и ответим вам в кратчайшие сроки.
Поделитесь с коллегами:
 

Не тратьте свое время! Подключайтесь к API прямо сейчас!

Генерация ключа занимает меньше минуты. Ключ будет мгновенно выслан вам на почту.