# Introducing API version 4
As the amount of traffic increases, we come up with solutions to handle the traffic. Nowadays we handle 2 million requests per hour (4 million on peak), which is great, but it requires proper server capacity and effective software that scales with the amount of traffic that make this service reliable.
# OpenResty, LuaJIT and lua-vips
With API version 4 we decided to rewrite to complete code base to Lua and switch to OpenResty(opens new window), which turns nginx(opens new window) and LuaJIT(opens new window) into a full-fledged scriptable web platform. For image handling and manipulation we still use the libvips(opens new window) image processing library under the hood. We have only moved from the PHP-binding(opens new window) to the Lua binding(opens new window).
You may wonder why we did this; it's because OpenResty is robust, fast and scales with the amount of traffic we are processing nowadays. One of the core benefits of OpenResty is that it is fully asynchronous and that our code can be written directly inside Nginx without using PHP-FPM and FastCGI. The amazing just-in-time (JIT) compilation and the integrated foreign function interface (FFI) in LuaJIT have also been motives to move away from PHP.
Perhaps you've already noticed, https://images.weserv.nl/ already states that API version 4 is running. This is not a mistake, our A/B testing went so well that we decided (on time of writing) to forward all traffic to API version 4.
# What has changed for the end user?
Absolutely nothing, all parameters listed on API 3 still work on API 4. The only thing you might notice is when you process an image, that it will load faster. If you found something odd, don't hesitate to contact us.
We track support tickets, issues and feature requests using the GitHub issue tracker(opens new window).
# What has been added?
We introduced some new parameters and a more flexible URI parser.
- Mask type
&mask. Sets the mask type from a predefined list of shapes:
triangle-180: Triangle tilted upside down
pentagon-180: Pentagon tilted upside down
square: Square tilted 45 degrees
star: 5-point star
- Mask trim
&mtrim. Removes the remaining whitespace from the mask.
- Mask background
&mbg. Sets the background color of the mask.
# Flexible URI parser
With API 4 we are supporting URI's starting with
https://. Previously this would result in
an error to prevent BBCode parsers to fail on the double
http(s)://-part. Because Markdown is
increasingly becoming the standard for user input, we decided to make the URI parser more flexible.
Note that we will still support
?url=//…-requests for backwards compatibility.
# Where can I view the code?
The code is available on the 4.x branch(opens new window), this will become the default branch in the future.