Better failure and timeout handling

Requests fail within 90 seconds instead of retrying for minutes, and every API error is returned as JSON.

Changelog1 min read

Written by

Dmytro Krasun

Published on

When our rendering servers were unavailable or slow, the API could retry a request on several servers, each time with a new time limit, so a request could take several minutes before failing.

Now the API waits at most 90 seconds in total for its rendering servers, including any retry on another server:

  • Requests fail sooner. Some requests that used to succeed after long retries now fail with an error instead. Retrying such a request later is safe.
  • Timeouts are no longer retried. If a rendering server times out, the request fails, because the render may still be running and a retry would render the screenshot twice. This includes GPU rendering: without fail_if_gpu_rendering_fails, the request falls back to CPU rendering only when the GPU servers are unavailable and enough time is left.
  • Large files aren’t cut off. The limit covers waiting for the rendering servers, not transferring the result, so a large PDF or video can finish downloading after it.

Errors are also more consistent:

  • Every error the API returns is JSON with error_code, error_message and documentation_url, as described in the errors documentation, including when a rendering server is unavailable.

See the timeout option.

Read more product updates

New features, bug fixes, and optimizations...

View all product updates
Better and more extensible PDF rendering

Better and more extensible PDF rendering

ScreenshotOne supports PDF rendering for a long time but it was used till recently by a small group of customers. Growing demand in PDF rendering required updating the API. And today, we introduce new options for PDF customization.

Read more

1 min read

Clearer taxes and VAT in billing

Clearer taxes and VAT in billing

Billing shows your next payment with tax, the company page explains how tax applies to your country, and a new guide covers VAT and invoices.

Read more

1 min read

ScreenshotOne integration with Dirstarter

ScreenshotOne integration with Dirstarter

Build a directory with Dirstarter and add website screenshots automatically with ScreenshotOne.

Read more

1 min read

Automate website screenshots

Exhaustive documentation, ready SDKs, no-code tools, and other automation to help you render website screenshots and outsource all the boring work related to that to us.