Doppio API is composed of very similar render methods but each with key differences. So, here is a guide to help you get started and find the one you need !
Doppio can return your document in 3 different ways:
Direct route will return your document directly in response to your request. Simple and efficient.
Sync route will not respond with the document directly but with the URL which temporarily host it after the document has been rendered.
If you provided a presigned URL, the URL will be from your own S3 bucket. See here for more info on this feature.
Async route will respond to your request immediately, then handle your request and call the provided webhook when the render is completed. The document is also passed on via the host URL. See here for more info on the async workflow.
Doppio can render your document as an image or a PDF. Supported image formats are PNG, JPEG, JPG and WEBP.
Making a request
All requests follow the same principles : a
POST request to the base URL
https://api.doppio.sh with some common params in the body.
Part of the body can change depending on the render mode or the document type requested. A
Image route will have respectively an optional
screenshot parameter for additional specifications.
Async routes will need a
webhook parameter specified in the body (nested inside
Here is a summary of all available routes and their specificities.
|Enpoint||Render mode||Document Type||Body|
|Direct||Common params, PDF params|
|Sync||Common params, PDF params|
|Async||Common params, PDF params, Async params|
|Direct||Image||Common params, Screenshot params|
|Sync||Image||Common params, Screenshot params|
|Async||Image||Common params, Screenshot params, Async params|