Handling errors

There are a number of potential error messages that can be returned from OneMusicAPI. In almost every case this is accompanied by a non-HTTP 200 response.

Timeout

Currently, if no results are found after 55 seconds, OneMusicAPI will abruptly terminate the request and return no more results. In this case, a HTTP 200 result is still returned. Worst case, the response will be:

[ ]

... although if other results were found before the 55 second timeout then they will also be displayed.

Common errors

HTTP status code Response body Rectification
400 title is mandatory If you are running a name based query, you must include the name of the release.
400 artist is mandatory If you are running a name based query, you must include the name of the artist of the release.
403 Authentication failed Your user_key parameter was either not included in the query or was invalid.
403 Authentication parameters missing Remember to include your user_key parameter.
comments powered by Disqus
© 2012-2018 elsten software limited, Unit 4934, PO Box 6945, London, W1A 6US, UK | terms and conditions | privacy policy