Simple Web API for resize image easily.

Powered by php-image-resize library.

https://resize.sardo.work

Currently, it will only resize image best to fit. Maybe add more function in the future.

You can host this file on your Web server. Support PHP 5.6 or PHP 7.

Install the dependencies:

$ composer install

All of the paramter is required, otherwise server will return error message.

The url of image. Accept png, jpg, gif, and webp, and the file which not larger than 500MB.

The width of resized image. Must be integer.

The height of resized image. Must be integer.

The quality of resized image.

Must be an integer ranging from 0 to 100 :

• 0 = no compression.
• 1 = worst quality, smaller file.
• 100 = best quality, biggest file.
• default value is 85

This only applies to JPG/JPEG and WEBP image files.

You can call the API to resize image with post method. Currently it only accept remote image.

Get cropped image by GET method:

You can just use the this url to crop the image. This method will return an cropped image directly, not JSON result.

https://resize.sardo.work/?imageUrl={image_url}&width={image_width}&height={image_height}&quality={image_quality}

Get cropped image by POST method:

fetch('https://apiserver.com', {
  body:JSON.stringify({
    width: 500,
    height: 300,
    quality: 50,
    imageUrl: 'http://example.com/image.png',
  }),
  headers: {
    'content-type': 'application/json',
  },
  method: 'POST',
})
.then(response => response.json())
.then((result) =>{
  console.log(result);
});

If everything is OK, it will return a JSON which contain status and cropped image data (Data url of resized image):

{ status: 'Success',
  filename: 'image-filename.jpg',
  cropped_image_data:
   '/9j/4AAQSkZJRgABAQAAAQABAAD//gA7Q1JFQVRPUjogZ2QtanBlZyB2MS4wICh1c2luZyBJSkcgSlBFRyB2OTApLCBxdWFsaXR5ID0gODUK/9sAQwAFAwQEBAMFBAQEBQUFBgcMCAcHBwcPCwsJDBEPEhIRDxERExYcFxMUGhURERghGBodHR8fHxMXIiQiHiQcHh8e/9sAQwEFBQUHBgcOCAgOHhQRFB4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4e/8IAEQgBLAHWAwEiAAIRAQMRAf/EABwAAAEFAQEBAAAAAAAAAAAAAAIAAQQFBgMHCP/EABkBAQEBAQEBAAAAAAAAAAAAAAABAgMEB...' }

The API will not keep your image.

Otherwise it will return a json which contain error message. For example:

{ status: 'Failed',
  error_message: 'Please provide the url of image.'}

You can test the api function without browser, there are a pre-ready script at frontend-test folder. It requires Node.js (Recommanded to use v10.x.x Version) to run.

Before use the script, install the dependencies by npm, then copy the config file:

cd frontend-test
npm install
cp config.example.json config.json

Edit the config file:

{
  "serverUrl": "Your api server url",
  "imageUrl": "Image for testing",
}

Then you can run it now.

node upload.js

If there are any bug, or request new function, please feel feel to open an issues or pull request.