Skip to content
On this page

Render PDF asynchronously

An async render request responds immediately that it understood your request, and will call you back on your webhook once the render is finished. A PDF request renders a PDF document.

An additional doppio.webhook param is required in the request body.

Route

Method: POST

Route: api.doppio.sh/v1/render/pdf/async

Examples

Request

Response

json
{
  "requestId": "doppioreq_640d0598-0413-4385-8e4a-0ee43d531609",
  "jobId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Webhook

json
{
  "doppioRequestId": "doppioreq_640d0598-0413-4385-8e4a-0ee43d531609",
  "renderStatus": "SUCCESS",
  "documentUrl": "https://tmp.doppio.sh/doppioreq_640d0598-0413-4385-8e4a-0ee43d531609-1661856673637.pdf",
  "isAsync": true,
  "isCustomBucket": false
}

Body

  • Common body params doppio, page and launch: see here.

  • PDF body params page.pdf: see here.

  • Async body param doppio.webhook: see here.

Response

To get a list of all possible response codes, see here

If everything goes well, Doppio will respond with the following payload:

Property nameTypeDescription
requestIdstringRequest identifier. Used to link your request to the webhook request
jobIdstringRender job identifier. Save it in case you need to contact us about your request.

Webhook

Once render is finished, Doppio will call the provided webhoook endpoint with the following payload :

Property nameTypeDescription
doppioRequestIdstringRequest identifier.
renderStatusstringRendering status of your document. Can be either SUCCESSor ERROR
documentUrlstringURL to access your rendered document
isAsyncbooleanIf the request is async. Will always be truefor this request method
isCustomBucketbooleanIf the document is hosted on your own S3 bucket or temporarily on our own.

All rights reserved