HTML to PDF

Renda offers a host of transformation functions to support a variety of enterprise document output needs.

Transform HTML to PDF

With Renda' HTML to PDF transformation API - HTML output can be converted to PDF document. Optionally the PDF document can also password protected by using AES 256 encryption algorithm.

API calls are region specific. Please make sure you are subscribed to a specific region before making API calls.

Ping

GET https://api-<region>.renda.io/v2/ping/

This API perform a heartbeat check to verify if the configuration is all setup correctly from your application. Region specific URLs: Ireland(Europe): https://api-eu.renda.io/v2/ping North Virginia(US): https://api-us.renda.io/v2/ping Mumbai (Asia Pacific): https://api-apac.renda.io/v2/ping

Headers

Name	Type	Description
x-api-key	string	Renda.io API Key A valid renda.io user account is required to view API Key

200 Successful Ping

{
    "message": "Renda.io ping Successful"
}

403 Invalid API Key

{
"message”:”We are unable to service your request. Things to verify: 
1) A valid API Key should be passed in ‘x-api-key’ request header parameter.
 2) An active Renda.io subscription 3) API being invoked must be Subscribed 
 using the Subscribe button in Renda developer portal. Please refer to Renda 
 documentation for more details - https://documentation.renda.io"
}

Generate PDF

POST https://api-<region>.renda.io/v2/generatePDF

This API enables conversion of HTML and text documents in PDF. Optionally the generated PDF can also be encrypted Region specific URLs: Ireland(Europe): https://api-eu.renda.io/v2/generatePDF North Virginia(US): https://api-us.renda.io/v2/generatePDF Mumbai(APAC):https://api-apac.renda.io/v2/generatePDF

Headers

Name	Type	Description
x-api-key*	string	Renda API Key
Accept	string	application/pdf
Content-type	string	application/x-www-form-urlencoded

Request Body

Name	Type	Description
inputPayload	string	HTML payload to transform to PDF format
encryptionKey	string	Encryption key to password protect the generated PDF
landscape	boolean	Paper orientation. Defaults to false
format	string	Paper Format. Defaults to A4 Valid Options: Letter, Legal, Tabloid, Ledger, A0,A1,A2,A3,A4,A5,A6 Letter: 8.5in X 11in Legal: 8.5in x 14in Tabloid: 11in x 17in Ledger: 17in x 11in A0: 33.1in x 46.8in A1: 23.4in x 33.1in A2: 16.54in x 23.4in A3: 11.7in x 16.54in A4: 8.27in x 11.7in A5: 5.83in x 8.27in A6: 4.13in x 5.83in
marginTop	string	Paper Margin top Defaults to blank Top margin, accepts values labeled with units Example: 50px
marginRight	string	Paper Margin right Defaults to blank Right margin, accepts values labeled with units
marginBottom	string	Paper Margin bottom Defaults to blank Bottom margin, accepts values labeled with units
marginLeft	string	Paper Margin Left Defaults to blank Left margin, accepts values labeled with units
header	string	HTML payload for PDF header
footer	string	HTML payload for PDF footer

200 A valid PDF document is returned as a success response

%PDF-1.4
%����
1 0 obj
<</Creator (Chromium)
/Producer (Skia/PDF m83)
........
....<PDF Content>...
.......
%%EOF

500 PDF Generation error will be notified via HTTP 500 errors

{
"<Error Response from Server>"
}

403: Forbidden Invalid API Key

{
"message”:”We are unable to service your request. Things to verify: 
1) A valid API Key should be passed in ‘x-api-key’ request header parameter.
 2) An active Renda.io subscription 3) API being invoked must be Subscribed 
 using the Subscribe button in Renda developer portal. Please refer to Renda 
 documentation for more details - https://documentation.renda.io"
}