msagency/msa-fakeimage repository overview

⁠msa-fakeimage

Dynamic image generator. Can generate png, jpg and gif images at various resolutions.

Built with the fakeimage⁠ ruby app.

⁠Quick start

Execute the microservice container with the following command :

docker run -ti -p 9905:80 msagency/msa-fakeimage

⁠Example(s)

To get a png image of dimensions 850x50, just specify the size (width x height) in the url :

/fakeimage/850x100.png⁠

Specify the background color with the color parameter, specify either a color name (the full list is available on the imagemagick ⁠ website) :

/fakeimage/850x100.png?color=DeepSkyBlue⁠

Or you can use a hex code, starting with ! instead of # :

/fakeimage/50x500.jpg?color=!4bfc57⁠

You can also change the text color with the textcolor parameter :

/fakeimage/850x100.jpg?color=black&textcolor=!43ff00⁠

⁠Endpoints

• /fakeimage/:resolution⁠ : Returns a png image
• /fakeimage/:resolution.png⁠ : Returns a png image
• /fakeimage/:resolution.jpg⁠ : Returns a jpg image
• /fakeimage/:resolution.gif⁠ : Returns a gif image

⁠Standard endpoints

• /ms/version⁠ : returns the version number
• /ms/name⁠ : returns the name
• /ms/readme.md⁠ : returns the readme (this file)
• /ms/readme.html⁠ : returns the readme as html
• /swagger/swagger.json⁠ : returns the swagger api documentation
• /swagger/#/⁠ : returns swagger-ui displaying the api documentation
• /nginx/stats.json⁠ : returns stats about Nginx
• /nginx/stats.html⁠ : returns a dashboard displaying the stats from Nginx

⁠About

A project by the Microservices Agency⁠.