API description

Site key

You must obtain a key for your site by sending en email to flepied at gmail dot com with the URL of your site, a one line description of your site and the IP address which will download the photo images.

Download process

The process to retrieve photos is a 2 steps process to avoid too much traffic on our web site.

Email key

The first step is to request the global key of an email. You must not ask for photos multiple times so if this global key hasn't change, you must continue to use your save copies.

The URL to retrieve this global key is the following: http://email2photo.net/verify/<site key>/<email chksum>/.

The <email chksum> is computed like in the foaf specification. For example, in python you can use something like this:

email_chksum = sha.new('mailto:' + email).hexdigest()

Images

If the email key has changed, you can then download the images in jpeg format with the following URL either in 32, 64 or 128 bit format:

• http://email2photo.net/32/<site key>/<email chksum>/<email key>/
• http://email2photo.net/64/<site key>/<email chksum>/<email key>/
• http://email2photo.net/128/<site key>/<email chksum>/<email key>/

URL

If there is no answer from the verify call, you can also request an URL of a photo using this URL: http://email2photo.net/url/<site key>/<email chksum>/.

There is no guarantee that the photo is the correct one and no guarantee on the format and on the copyright.