Accounts created before Nov. 1st, 2021
Accounts created before November 1, 2021 have to include /v7/ in the path, like shown below.
//token.cloudimg.io/v7/original_image_url?operations&filters
Accounts created on or after November 1, 2021 do not require /v7/ and documentation have been updated accordingly.
To verify the type of configuration on your Cloudimage account, log in to your Cloudimage admin panel and look at the syntax provided on the Welcome page.
[NOTE] If you are an existing Cloudimage customer and wish to be able to remove the v7 from your URL syntax, please contact our support.
Content Delivery Network
Cloudimage leverages Content Delivery Networks to accelerate the delivery of your images worldwide. We work with multiple CDN providers to optimise the delivery of your images and provide superb reliability.
In addition to accelerating your images, the CDN provides DDoS (Distributed Denial of Service) protection, which will act as a shield to your servers and avoid any downtime.
CDNs usually cache images for as long as the images are requested by end users. If you want to update an original image, you have two ways of doing so in the CDN cache.
Invalidation
To refresh your images, you can either update the Cloudimage URL or invalidate them to flush them from the resizing servers and the CDN.
Option 1: add version in the origin image URL to force the CDN to download the new image
Old image:
//doc.cloudimg.io/sample.li/flat.jpg?w=500
New image:
//doc.cloudimg.io/sample.li/flat.jpg?w=500&v2
The v2 wil force the CDN to handle sample.li/flat.jpg?w=500&v2 as a new image version and update it's cache.
Option 2: invalidate the image from the CDN and Cloudimage caches
If you cannot change the image URLs when changing the origin image, you can still invalidate (flush) the image from the Cloudimage admin console. Log in to the console and navigate to Invalidation:
Do not use the full path of your image but only the /origin_image_url?operation&filter part as invalidation path. For example, to invalidate //doc.cloudimg.io/sample.li/flat1.jpg?w=500, you need to input /sample.li/flat1.jpg?w=500.
This will remove the image(s) from all CDN nodes and Cloudimage resizing servers.
The invalidation field assumes you are listing v7 Cloudimage paths. If you want to invalidate v6 Cloudimage URLs, you need to check the Use v6 API option.
Option 3: use our invalidation REST API
Alternatively, the Invalidation API allows to invalidate images via API.