Big update to the readme

Added in-depth explanations and examples of all possible outcomes of a request and the output, and most importantly the state that they will produce