A Minotar is a global avatar that pulls your head off your Minecraft.net skin, and allows it for use on several thousand sites - anywhere you can embed an image. See some uses below.
Unlike the PayPal API, we keep things nice and simple. For basic usage just provide a username:
<img src="https://minotar.net/avatar/clone1018">
You can also set a size. We use pixels and we only need the width. Just add it to the end.
<img src="https://minotar.net/avatar/clone1018/100">
And since some services require an extension we've added simple support for it. Just add .png to the end.
<img src="https://minotar.net/avatar/clone1018/100.png">
Sometimes you want to display a helm too, that's fine with this endpoint.
<img src="https://minotar.net/helm/clone1018/100.png">
You can even use Minotar's API to get a users skin. We're adding more soon!
<img src="https://minotar.net/skin/clone1018">
You can also set the browser to download the image by using:
https://minotar.net/download/clone1018
Need Steve? Use "char" as the username:
<img src="https://minotar.net/skin/char">
- Coming Soon -
We use a couple of headers to help in understanding how something is served, here they are:
x-requested
- returns: processed
- explain: if Minotar processed your avatar
x-result:
- returns: ok,failed
- explain: ok on successful GET from s3, failed on failed GET from s3
x-timing:
- returns: fetch time, process time, resize time, whole process
- example: 48+0+4=52
Big thanks to lukegb for porting the old version of this script from PHP to Go.