20140425 - image endpoint

[Dan Gravell]

This release of OneMusicAPI adds a new image endpoint. This means OMA can be used to proxy images from the various databases it aggregates.

Currently, Discogs and MusicBrainz are supported. Requests take the form of:

http://onemusicapi-beta.elasticbeanstalk.com/20140425/image/[source]/[source release id]/[image num]

Where all items in square brackets are required and:

source: "musicbrainz" or "discogs"

source release id: the release ID on the source, e.g. a MBID or a Discogs release ID

image num: the 1-based integer index of the image. If in doubt, use "1".

Examples:

http://onemusicapi-beta.elasticbeanstalk.com/20140425/images/musicbrainz/16a2fa8b-480e-3d58-8c42-684b9bec1493/1

http://onemusicapi-beta.elasticbeanstalk.com/20140425/images/discogs/1806152/1

(Note currently the image URLs hardcode api.onemusicapi.com - that's fine for release but when working with the beta you'll have to change those to onemusicapi-beta.elasticbeanstalk.com)

Results from metadata queries to /release/ and /disc/ for the 20140425 version will also begin to return these URLs where appropriate. This means all Discogs images will be returned with OMA image URLs, and some MusicBrainz URLs (see below). When used against a released version of OMA, the client's user_key will need to be specified to fetch the image. For versions earlier than 20140425 the original source URL will continue to be returned.

The MusicBrainz images that will be proxied by OMA are all those provided by Amazon. This version also re-introduces Amazon cover art support for the first time in two years... a change that should see a 10% improvement (roughly) in cover art coverage. Cover Art Archive URLs will continue to be returned as-is.

Dan