improve documentation around usage
add constants to make returnCode less magical
update README with client example