readme fix
added fixes for inexistent user
improved error handling
added return values for api specification