API Key Errors

An invalid API key will return a JSON error and set a HTTP/1.1 401 Unauthorized http status.

Example error response

{
	"status": "failure",
	"error": "invalid API key"
}

{
	"status": "failure",
	"error": "invalid development API key"
}

{
	"status": "failure",
	"error": "invalid development API permission (scrobble)"
}

Authentication Errors

Invalid user credentials (username or password) will return a JSON error and set a HTTP/1.1 401 Unauthorized http status.

Example error response

{
	"status": "failure",
	"error": "failed authentication",
}

Server Over Capcity

If the server is over capacity, it will return a JSON error and set a HTTP/1.1 503 Service Unavailable http status. If you encounter this error, we recommend waiting 10 seconds or so, then retry the API call. This error typically indicates a temporary server issue that should resolve itself quickly, so the 2nd call will likely go through. Its worth putting a retry cap just to make sure it's not infinitely retrying in the event a true outage.

Example error response

{
	"status": "failure",
	"error": "server is over capacity"
}