A clearer error for failed HTTPS connections

The new secure_connection_failed error explains HTTPS connection failures and how to request a public page over HTTP when appropriate.

Changelog1 min read

Written by

Dmytro Krasun

Published on

A website can work over HTTP while its HTTPS connection fails. These failures have been reported as a generic network_error, which makes it harder to understand why the screenshot failed and whether retrying will help.

We’re introducing secure_connection_failed for failures to establish a secure HTTPS connection to the target website. The error message explains the problem and suggests checking the site’s HTTPS configuration or trying its public HTTP URL.

If a public page works over HTTP, you can explicitly pass url=http://example.com while keeping the ScreenshotOne API endpoint on HTTPS. Use this only when an unencrypted connection to the target is acceptable and the request contains no credentials or sensitive data. ScreenshotOne does not automatically switch HTTPS requests to HTTP.

During rollout, these failures may still return network_error, so keep handling both error codes. See how to handle API errors for an updated example of showing the error to your users and deciding when to retry.

Read more product updates

New features, bug fixes, and optimizations...

View all product updates
ScreenshotOne on the Postman Public API Network

ScreenshotOne on the Postman Public API Network

You can now play with the ScreenshotOne API in Postman using many examples as starting points for integrations.

Read more

1 min read

Slice full-page screenshots

Slice full-page screenshots

Full-page screenshots can now be split into smaller vertical slices for better AI analysis workflows.

Read more

1 min read

Get the HTTP response status code and headers with screenshots

Get the HTTP response status code and headers with screenshots

On rare occasions, you might need to get the HTTP status code and headers of the target host. It is pretty easy to do now.

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.