Basics

Using our API is really easy. Just post an image to our store-page:

<form action="http://imm.io/store/" method="post"
      enctype="multipart/form-data">
   <input name="image" type="file" />
   <input type="submit" />
</form>

Try it out:

What you get back

The response back is a simple json string. That contains a success field and a payload field. Incase of an error the success field is set to false and payload is the error message.

{ "success": true, "payload": {
  "uid": "AA01",
  "uri": "http://i.imm.io/AA01.png",
  "link": "http://imm.io/AA01",
  "name": "image.png",
  "format": "PNG",
  "ext": "png",
  "width": 800,
  "height": 640,
  "size": "2 KB"
}}

Base64 encoded image

We also accept images that are encoded using base64 string encoding. If you use this option you also have to supply the name of the image with the name parameter.

<form action="http://imm.io/store/" method="post" 
      enctype="multipart/form-data">
   <input name="name" value="logo.png" type="hidden" />
   <input name="image" 
          value="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..." 
          type="hidden" />
   <input type="submit" />
</form>

Try it out:

Metadata

Metadata works by adding a JSON string to the meta parameter, the only piece of meta data that is used right now is referrer data, if you supply referrer data you will get recognition and a link of you choice displayed on the viewpage.

{ 
   "referrer": { 
      "name": "Example service", 
      "url": "http://example.com/" 
   } 
}

Example:

Icon

If you want an icon for you application use this:

Limitations

We limit the number of uploads to 50 per hour and per IP address.