Skip to content

Render PDF synchronously

A sync render request returns a document URL once the render is finished, instead of returning the raw document directly. In this case, the output is a PDF. You can also add an optional body parameter if you want Doppio to upload the rendered file to your own S3 bucket.

Route

Method: POST

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

Examples

Request

Response

json
{
  "doppioRequestId": "doppioreq_640d0598-0413-4385-8e4a-0ee43d531609",
  "renderStatus": "SUCCESS",
  "documentUrl": "https://www.url-to-custom-bucket.com/yourfile.pdf",
  "isAsync": false,
  "isCustomBucket": true
}

Body

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

  • PDF body parameters page.pdf: see here.

Response

For the full list of possible response codes, see What to expect from us.

If the request succeeds, Doppio responds with the following payload:

Property nameTypeDescription
doppioRequestIdstringUnique identifier for the request.
renderStatusstringRendering status for your document. Either SUCCESS or ERROR.
documentUrlstringURL where you can access the rendered document.
isAsyncbooleanWhether the request is asynchronous. For this render method, the value is always false.
isCustomBucketbooleanWhether the document is stored in your own S3 bucket or temporarily in ours.

All rights reserved