API calls should always return JSON in case of errors

[Vallenain]

The calls to /api/0.1/ return HTML document in case of error (I think it's the default behaviour of Laravel). But for APIs, those responses should be programmatically read and so we'd need a standard JSON error object. Probably something like

{
  error_code: 'AN_ERROR_IDENTIFIER',
  error_message: 'some human readable message, for the developper mostly'
}

[vpmalley]

and a good way to resolve this is in the answers of this question: http://stackoverflow.com/questions/28444556/laravel-5-general-error-as-json

[vpmalley]

fixed, the chosen format is:

{ "error": { "status" : <number>, "message" : <string> } }

where the status is a HTTP status code. It can be returned by writing anywhere abort(status, message); in the PHP code.