document mobile API some more
js variable naming consistency
normalize JSON API for use in mobile client
improve API doc