updated readme with two use cases, changed comments on api request