Errors handling
Whenever something goes wrong, TwicPics will issue an HTTP error with a sensible status code and a short explanation in plain text as a body.
TwicPics will error when:
- There is a syntax error in the manipulation expression
- The authentication identifier is invalid
- The URL of the source asset is not well-formed, or its protocol is not supported
- The domain of the source asset is not registered (see the documentation about domain name registration)
- The source asset is unreachable (i.e., the
GET
request to retrieve it resulted in an HTTP error) - The source asset is of an unsupported format (only AVIF, GIF, HEIF, JPEG, PNG, and WebP, and most
video
files are currently supported) - The source asset, the output asset, or any intermediate asset created while processing the transformations doesn't respect the internal pixel and/or byte size limits of TwicPics (i.e., one of the assets has a dimension of zero or is "too big")
- A transformation ends up cropping outside of the asset (for instance, when attempting to crop 500 pixels out of an asset that is only 200 pixels wide)
Whenever an asset does not show on your web page, check the network tab of your favorite dev tool for those red-colored lines indicative of a network error.