Convert html to pdf with a retry mechanism

Piotr Żaba — Mon, 17 Oct 2022 15:36:22 +0000

Now that you know what is HTMLeer.dev we can learn how to use it.

Get your API key

If you don't have an account, just head to Register page.
After registration go to API keys using navigation bar and create new one.

API documeentation

You can find available options in our swagger documentation.

Usage of the API

It's really simple, all you need to do is call HTMLeer API with your API key. Here's an example how you can create and download pdf file using HTMLeer API (with a help of p-retry in case of any failures).

import pRetry, { AbortError } from 'p-retry';

const generatePDF = async () => {
    const response = await fetch('https://api.htmleer.dev/v1/generate/pdf', {
        method: 'POST',
        body: JSON.stringify({
            savePdf: false,
            filename: 'my-file',
            html: `<div>Hello {{ name }}!</div>`,
            arguments: { name: 'HTMLeer' },
            options: { format: 'A4' }
        }),
        headers: {
            'content-type': 'application/json',
            'api-key': process.env.HTMLEER_API_KEY
        },
    });

    // we are stopping retrying because its custom api error
    if (!response.ok && response.status < 500) {
        throw new AbortError(response.statusText);
    }

    if (!response.ok) {
        throw new Error(response.statusText);
    }

    return response.arrayBuffer();
};

try {
    const result = await pRetry(generatePDF, { retries: 5 });
    const blob = new Blob([result], { type: "application/pdf" });
    const objectUrl = URL.createObjectURL(blob);
    window.open(objectUrl);
} catch (err) {
    console.log(err);
}

What do you think?

About HTMLeer.dev API

Piotr Żaba — Tue, 20 Sep 2022 12:33:44 +0000

HTMLeer provides REST API for your next application, which will make it easier for you to generate pdfs and images without worrying much about architecture, cost and scaling issues.

Features

generating pdf/image based on html input
saving generated file on s3
streaming a file back to the client without saving on s3
possibility to use options provided by puppeteer
possibility to use handlebars syntax
use of dynamic arguments
management panel for your api keys, allowed origins, saved files and subscription status

How it works?

client creates his account on HTMLeer management panel
client sets up new api key
client uses HTMLeer documentation and makes his request to the api with already created api key
api in response returns buffer of the file or object with link to saved file

Pricing

There are free 100 API generations each month, it should be enough for small applications.

You can also buy additional API generations, which does not have any use time limitations:
1000 generations: 5$ + tax
5000 generations: 15$ + tax
25000 generations: 50$ + tax
100000 generations: 100$ + tax

Thanks for reading!

Forem: Piotr Żaba