|
We will be releasing Version 3 of the Echo Nest API on Monday, January 19-th 2009. Here is what's coming:
- Backwards compatibility notes: We will continue to support version 2 until the next major revision is released. A version parameter is required to use version 3. Calls without this parameter will default to version 2.
- New format for entity identifiers. Starting in version 3, the API will use URLs structured like this:
music://id.echonest.com/owner/typename/key
- owner is the creator of the identifier.
- For automatically-assigned identifiers, this is ~.
- For identifiers that you create, it is your API Key.
- typename is one of the following:
- AR - used to designate an artist
- TR - used to designate a track
- key is a case-sensitive, alphanumeric string that refers to a specific entity of the given type.
- New calls: add_id and delete_id. Uses these to manage your own identifiers.
- New parameter for all calls: context. It is a free-form character field that will not affect the results of the
API call, but will be returned along with the other parameters in the response. Use this parameter for
organizing connection pools and batch processing. It is also available in version 2.
- New parameter for search_artists: sounds_like. Indicates whether to use sound alike searching or just
strict matching.
-
End of life for passing artist names or MusicBrainz IDs to Artist calls. Artist name matching can be
unpredictable and increases the response time. It is better to query search_artists first to get an exact
identifier. Use add_id and delete_id to create persistent mappings to your own artist data.
-
The XML response formats have been changed so there is a uniform style. The documentation has
specifics, but these are the major changes:
Uniform casing (with_underscores, no CamelCasing?).
The responses for all Track methods has been simplified.
Timestamps are now correctly formatted for the XML dateTime datatype.
- Error codes/messages have beens simplified across the board. See the documentation for specifics.
|