https://github.com/luizfonseca/imagery

Image-Processing API using Golang that supports AuthZ/N and CDN caching
https://github.com/luizfonseca/imagery

Last synced: 2 days ago
JSON representation

Image-Processing API using Golang that supports AuthZ/N and CDN caching

• Host: GitHub
• URL: https://github.com/luizfonseca/imagery
• Owner: luizfonseca
• Created: 2021-06-17T21:10:31.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2021-06-20T19:51:46.000Z (over 3 years ago)
• Last Synced: 2024-06-19T13:35:51.688Z (4 months ago)
• Language: Go
• Size: 1.09 MB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        


---

- [API definition](#api-definition)

  - [GET v1/image](#get-v1image)

## API definition

### GET v1/image

Supported params:

- `url`

  -  an HTTP 1.1 or HTTP2 based URL that returns an image when GET HTTP method is used.

  - If an image is not returned from the URL, the transformation will fail with HTTP 400 (BadRequest)

  - Supported formats: `JP[E]G, PNG, WebP, GIF, BMP`

- `format`

  - Converts the provided image to the specified format. Supported `WebP, JPG, JPEG, PNG, GIF`. If the format is not specified, the original format is returned.

- `quality`

  - Image quality when returning the new image.

- `resizeW`

- `resizeH`

- `aspectRatio`

- `filter[]`

  - Multiple filters can be applied at the same time, such as:

    - `filter[grayscale]`:

    - `filter[blur]`:

- `rotateDeg`

  - rotates based on a degree, e.g. `180` rotates 180 degrees.

- `flip=true`

  - Flips the image (inverts it completely)

- `cacheControl=`

  - If specified, will return the value as part of the response headers in order to instruct clients of a particular cache control.

The result will be an image with all the transformations applied. 

A subsequent request will return a cached version of the transformed image (if params are kept the same).